XmlWriter Classe

Définition

Espace de noms:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

Représente un enregistreur qui fournit un moyen rapide, non mis en cache, de transférer uniquement pour générer des flux ou des fichiers qui contiennent des données XML.

public ref class XmlWriter abstract : IAsyncDisposable, IDisposable

public abstract class XmlWriter : IAsyncDisposable, IDisposable

type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable

Héritage

Object

XmlWriter

Dérivé

System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Implémente

IDisposable IAsyncDisposable

Exemples

L’exemple de code suivant montre comment utiliser l’API asynchrone pour générer du code XML.

async Task TestWriter(Stream stream)
{
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.Async = true;

    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {
        await writer.WriteStartElementAsync("pf", "root", "http://ns");
        await writer.WriteStartElementAsync(null, "sub", null);
        await writer.WriteAttributeStringAsync(null, "att", null, "val");
        await writer.WriteStringAsync("text");
        await writer.WriteEndElementAsync();
        await writer.WriteProcessingInstructionAsync("pName", "pValue");
        await writer.WriteCommentAsync("cValue");
        await writer.WriteCDataAsync("cdata value");
        await writer.WriteEndElementAsync();
        await writer.FlushAsync();
    }
}

Remarques

La XmlWriter classe écrit des données XML dans un flux, un fichier, un texte ou une chaîne. Il prend en charge les recommandations W3C Extensible Markup Language (XML) 1.0 (quatrième édition) et Espaces de noms dans XML 1.0 (troisième édition).

Les membres de la XmlWriter classe vous permettent de :

• Vérifiez que les caractères sont des caractères XML légaux et que les noms d’éléments et d’attributs sont des noms XML valides.
• Vérifiez que le document XML est bien formé.
• Encoder des octets binaires en base64 ou BinHex et écrire le texte résultant.
• Transmettez des valeurs à l’aide de types Common Language Runtime au lieu de chaînes pour éviter d’avoir à effectuer manuellement des conversions de valeurs.
• Écrivez plusieurs documents dans un flux de sortie.
• Écrivez des noms valides, des noms qualifiés et des jetons de nom.

Créer un enregistreur XML

Pour créer une XmlWriter instance, utilisez la XmlWriter.Create méthode. Pour spécifier l’ensemble de fonctionnalités que vous souhaitez activer sur l’enregistreur XML, passez une XmlWriterSettings à la Create méthode. Sinon, les paramètres par défaut sont utilisés. Pour plus d’informations, consultez les Create pages de référence.

Spécifier le format de sortie

La classe XmlWriterSettings comprend plusieurs propriétés qui contrôlent la façon dont la sortie de XmlWriter est formée.

Propriété	Description
Encoding	Spécifie l’encodage de texte à utiliser. La valeur par défaut est Encoding.UTF8.
Indent	Indique s’il faut mettre en retrait les éléments. La valeur par défaut est false (aucune mise en retrait).
IndentChars	Spécifie la chaîne de caractères à utiliser lors de la mise en retrait. La valeur par défaut est deux espaces.
NewLineChars	Spécifie la chaîne de caractères à utiliser pour les sauts de ligne. La valeur par défaut est \r\n (retour chariot, saut de ligne) pour les plateformes non Unix et \n (saut de ligne) pour les plateformes Unix.
NewLineHandling	Spécifie comment gérer les caractères de nouvelle ligne.
NewLineOnAttributes	Indique s’il faut écrire des attributs sur une nouvelle ligne. Indent doit être défini sur true lors de l’utilisation de cette propriété. La valeur par défaut est false.
OmitXmlDeclaration	Indique s’il faut écrire une déclaration XML. La valeur par défaut est false.

Les propriétés Indent et IndentChars contrôlent la mise en forme de l’espace blanc insignifiant. Par exemple, pour mettre en retrait les nœuds d’élément :

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("books.xml", settings);

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Utilisez la NewLineOnAttributes commande pour écrire chaque attribut sur une nouvelle ligne avec un niveau supplémentaire de retrait :

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.NewLineOnAttributes = true;
XmlWriter writer = XmlWriter.Create("books.xml", settings);

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.NewLineOnAttributes = True
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Conformité des données

Un enregistreur XML utilise deux propriétés de la XmlWriterSettings classe pour vérifier la conformité des données :

• La propriété CheckCharacters ordonne au writer XML de vérifier les caractères et de lever une exception XmlException si certains caractères sont hors de la plage autorisée telle que définie par le W3C.

• La ConformanceLevel propriété configure l’enregistreur XML pour vérifier que le flux en cours d’écriture est conforme aux règles d’un document XML 1.0 ou fragment de document bien formé, tel que défini par le W3C. Les trois niveaux de conformité sont décrits dans le tableau suivant. La valeur par défaut est Document. Pour plus d’informations, consultez la XmlWriterSettings.ConformanceLevel propriété et l’énumération System.Xml.ConformanceLevel .

  Niveau	Description
  Document	La sortie XML est conforme aux règles d’un document XML 1.0 bien formé et peut être traitée par n’importe quel processeur conforme.
  Fragment	La sortie XML est conforme aux règles d’un fragment de document XML 1.0 bien formé.
  Auto	L’enregistreur XML détermine le niveau de vérification de conformité à appliquer (document ou fragment) en fonction des données entrantes.

Écrire des éléments

Vous pouvez utiliser les méthodes suivantes XmlWriter pour écrire des nœuds d’élément. Pour obtenir des exemples, consultez les méthodes répertoriées.

Utilisation	À
WriteElementString	Écrivez un nœud d’élément entier, y compris une valeur de chaîne.
WriteStartElement	Pour écrire une valeur d’élément à l’aide de plusieurs appels de méthode. Par exemple, vous pouvez appeler WriteValue pour écrire une valeur typée, WriteCharEntity écrire une entité de caractère, WriteAttributeString écrire un attribut ou écrire un élément enfant. Il s’agit d’une version plus sophistiquée de la WriteElementString méthode. Pour fermer l'élément, vous appelez la méthode WriteEndElement ou WriteFullEndElement.
WriteNode	Pour copier un nœud d’élément trouvé à la position actuelle d’un objet XmlReader ou XPathNavigator. Lorsqu’elle est appelée, elle copie tous les éléments de l’objet source vers l’instance XmlWriter .

Écrire les attributs

Vous pouvez utiliser les méthodes suivantes XmlWriter pour écrire des attributs sur des nœuds d’élément. Ces méthodes peuvent également être utilisées pour créer des déclarations d’espace de noms sur un élément, comme indiqué dans la section suivante.

Utilisation	À
WriteAttributeString	Pour écrire un nœud d’attribut entier, y compris une valeur de chaîne.
WriteStartAttribute	Pour écrire la valeur d’attribut à l’aide de plusieurs appels de méthode. Par exemple, vous pouvez appeler WriteValue pour écrire une valeur typée. Il s’agit d’une version plus sophistiquée de la WriteElementString méthode. Pour fermer l’élément, vous appelez la WriteEndAttribute méthode.
WriteAttributes	Pour copier tous les attributs trouvés à la position actuelle d’un XmlReader objet. Les attributs écrits dépendent du type de nœud sur lequel le lecteur est actuellement positionné : - Pour un nœud d’attribut, il écrit l’attribut actuel, puis le reste des attributs jusqu’à la balise de fermeture de l’élément. - Pour un nœud d’élément, il écrit tous les attributs contenus par l’élément. - Pour un nœud de déclaration XML, il écrit tous les attributs de la déclaration. - Pour tous les autres types de nœuds, la méthode lève une exception.

Gérer les espaces de noms

Les espaces de noms sont utilisés pour qualifier les noms d’éléments et d’attributs dans un document XML. Les préfixes d’espace de noms associent des éléments et des attributs à des espaces de noms, qui sont à leur tour associés aux références d’URI. Les espaces de noms créent l’unicité d’élément et de nom d’attribut dans un document XML.

Le XmlWriter maintient une pile de namespaces qui correspond à tous les namespaces définis dans l’étendue de namespace actuelle. Lors de l’écriture d’éléments et d’attributs, vous pouvez utiliser des espaces de noms de la manière suivante :

• Déclarez manuellement des espaces de noms en utilisant la méthode WriteAttributeString. Cela peut être utile lorsque vous savez comment optimiser le nombre de déclarations d’espace de noms. Pour obtenir un exemple, consultez la WriteAttributeString(String, String, String, String) méthode.

• Remplacez la déclaration d’espace de noms actuelle par un nouvel espace de noms. Dans le code suivant, la méthode WriteAttributeString modifie l’URI de l’espace de noms du préfixe "x" de "123" à "abc".

  writer.WriteStartElement("x", "root", "123");
  writer.WriteStartElement("item");
  writer.WriteAttributeString("xmlns", "x", null, "abc");
  writer.WriteEndElement();
  writer.WriteEndElement();
  

  writer.WriteStartElement("x", "root", "123")
  writer.WriteStartElement("item")
  writer.WriteAttributeString("xmlns", "x", Nothing, "abc")
  writer.WriteEndElement()
  writer.WriteEndElement()
  

  Le code génère la chaîne XML suivante :

  <x:root xmlns:x="123">
    <item xmlns:x="abc" />
  </x:root>
  

• Spécifiez un préfixe d’espace de noms lors de l’écriture d’attributs ou d’éléments. La plupart des méthodes utilisées pour écrire des éléments et des attributs vous permettent de le faire. Par exemple, la WriteStartElement(String, String, String) méthode écrit une balise de début et l’associe à un espace de noms et un préfixe spécifiés.

Écrire des données typées

La WriteValue méthode accepte un objet CLR (Common Language Runtime), convertit la valeur d’entrée en sa représentation sous forme de chaîne en fonction des règles de conversion de type de données XSD (XML Schema Definition Language) et les écrit à l’aide de la WriteString méthode. Cela est plus facile que d’utiliser les méthodes de la XmlConvert classe pour convertir les données typées en valeur de chaîne avant de l’écrire.

Lors de l’écriture en texte, la valeur typée est sérialisée en texte à l’aide des XmlConvert règles de ce type de schéma.

Pour connaître les types de données XSD par défaut qui correspondent aux types CLR, consultez la WriteValue méthode.

Vous pouvez également utiliser XmlWriter pour écrire dans un magasin de données XML. Par exemple, la XPathNavigator classe peut créer un XmlWriter objet pour créer des nœuds pour un XmlDocument objet. Si des informations de schéma sont disponibles pour le magasin de données, la méthode WriteValue lève une exception si vous essayez de convertir en un type qui n’est pas autorisé. Si le magasin de données ne dispose pas d’informations de schéma disponibles, la WriteValue méthode traite toutes les valeurs comme un xsd:anySimpleType type.

Fermer l’enregistreur XML

Lorsque vous utilisez XmlWriter des méthodes pour générer du code XML, les éléments et les attributs ne sont pas écrits tant que vous n’appelez pas la Close méthode. Par exemple, si vous utilisez XmlWriter pour remplir un XmlDocument objet, vous ne pourrez pas voir les éléments et attributs écrits dans le document cible jusqu’à ce que vous fermez l’instance XmlWriter .

Programmation asynchrone

La plupart des XmlWriter méthodes ont des équivalents asynchrones qui ont « Async » à la fin de leurs noms de méthode. Par exemple, l’équivalent asynchrone est WriteAttributeStringWriteAttributeStringAsync.

Pour la méthode WriteValue, qui n’a pas d’équivalent asynchrone, convertissez la valeur de retour en chaîne et utilisez la méthode WriteStringAsync à la place.

Considérations relatives à la sécurité

Tenez compte des éléments suivants lors de l’utilisation de la XmlWriter classe :

• Les exceptions levées par la méthode XmlWriter peuvent divulguer des informations sur le chemin que vous ne souhaitez pas faire remonter à l'application. Votre application doit intercepter les exceptions et les traiter de manière appropriée.

• XmlWriter ne valide aucune donnée transmise aux méthodes WriteDocType ou WriteRaw. Vous ne devez pas transmettre de données arbitraires à ces méthodes.

Constructeurs

Nom	Description
XmlWriter()	Initialise une nouvelle instance de la classe XmlWriter.

Propriétés

Nom	Description
Settings	Obtient l’objet XmlWriterSettings utilisé pour créer cette XmlWriter instance.
WriteState	En cas de substitution dans une classe dérivée, obtient l’état de l’enregistreur.
XmlLang	En cas de substitution dans une classe dérivée, obtient l’étendue actuelle xml:lang .
XmlSpace	En cas de substitution dans une classe dérivée, obtient une XmlSpace valeur représentant l’étendue actuelle xml:space .

Méthodes

Nom	Description
Close()	En cas de substitution dans une classe dérivée, ferme ce flux et le flux sous-jacent.
Create(Stream, XmlWriterSettings)	Crée une XmlWriter instance à l’aide du flux et XmlWriterSettings de l’objet.
Create(Stream)	Crée une XmlWriter instance à l’aide du flux spécifié.
Create(String, XmlWriterSettings)	Crée une XmlWriter instance à l’aide du nom de fichier et XmlWriterSettings de l’objet.
Create(String)	Crée une XmlWriter instance à l’aide du nom de fichier spécifié.
Create(StringBuilder, XmlWriterSettings)	Crée une XmlWriter instance à l’aide des objets et StringBuilder des XmlWriterSettings objets.
Create(StringBuilder)	Crée une XmlWriter instance à l’aide de l’élément spécifié StringBuilder.
Create(TextWriter, XmlWriterSettings)	Crée une XmlWriter instance à l’aide des objets et TextWriter des XmlWriterSettings objets.
Create(TextWriter)	Crée une XmlWriter instance à l’aide de l’élément spécifié TextWriter.
Create(XmlWriter, XmlWriterSettings)	Crée une XmlWriter instance à l’aide des objets et XmlWriter des objets spécifiésXmlWriterSettings.
Create(XmlWriter)	Crée une XmlWriter instance à l’aide de l’objet spécifié XmlWriter .
Dispose()	Libère toutes les ressources utilisées par l’instance actuelle de la XmlWriter classe.
Dispose(Boolean)	Libère les ressources non managées utilisées par les XmlWriter ressources gérées et libère éventuellement les ressources managées.
DisposeAsync()	Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation asynchrone des ressources non managées.
DisposeAsyncCore()	Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation asynchrone des ressources managées.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
Flush()	En cas de substitution dans une classe dérivée, vide ce qui se trouve dans la mémoire tampon sur les flux sous-jacents et vide également le flux sous-jacent.
FlushAsync()	Vide de manière asynchrone tout ce qui se trouve dans la mémoire tampon sur les flux sous-jacents et vide également le flux sous-jacent.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
LookupPrefix(String)	En cas de substitution dans une classe dérivée, retourne le préfixe le plus proche défini dans l’étendue d’espace de noms actuelle pour l’URI d’espace de noms.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
WriteAttributes(XmlReader, Boolean)	En cas de substitution dans une classe dérivée, écrit tous les attributs trouvés à la position actuelle dans le XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	Écrit de façon asynchrone tous les attributs trouvés à la position actuelle dans le XmlReader.
WriteAttributeString(String, String, String, String)	En cas de substitution dans une classe dérivée, écrit l’attribut avec le préfixe, le nom local, l’URI d’espace de noms et la valeur spécifiés.
WriteAttributeString(String, String, String)	En cas de substitution dans une classe dérivée, écrit un attribut avec le nom local, l’URI d’espace de noms et la valeur spécifiés.
WriteAttributeString(String, String)	En cas de substitution dans une classe dérivée, écrit l’attribut avec le nom et la valeur locaux spécifiés.
WriteAttributeStringAsync(String, String, String, String)	Écrit de façon asynchrone l’attribut avec le préfixe, le nom local, l’URI de l’espace de noms et la valeur spécifiés.
WriteBase64(Byte[], Int32, Int32)	En cas de substitution dans une classe dérivée, encode les octets binaires spécifiés en base64 et écrit le texte résultant.
WriteBase64Async(Byte[], Int32, Int32)	Encode de manière asynchrone les octets binaires spécifiés en base64 et écrit le texte résultant.
WriteBinHex(Byte[], Int32, Int32)	En cas de substitution dans une classe dérivée, encode les octets binaires spécifiés comme BinHex et écrit le texte résultant.
WriteBinHexAsync(Byte[], Int32, Int32)	Encode de manière asynchrone les octets binaires spécifiés sous BinHex et écrit le texte résultant.
WriteCData(String)	En cas de substitution dans une classe dérivée, écrit un <![ CDATA[...]]> bloc contenant le texte spécifié.
WriteCDataAsync(String)	Écrit de façon asynchrone un <![ CDATA[...]]> bloc contenant le texte spécifié.
WriteCharEntity(Char)	En cas de substitution dans une classe dérivée, force la génération d’une entité de caractère pour la valeur de caractère Unicode spécifiée.
WriteCharEntityAsync(Char)	Force de façon asynchrone la génération d’une entité de caractère pour la valeur de caractère Unicode spécifiée.
WriteChars(Char[], Int32, Int32)	En cas de substitution dans une classe dérivée, écrit du texte une mémoire tampon à la fois.
WriteCharsAsync(Char[], Int32, Int32)	Écrit de façon asynchrone du texte une mémoire tampon à la fois.
WriteComment(String)	En cas de substitution dans une classe dérivée, écrit un commentaire <--...--> contenant le texte spécifié.
WriteCommentAsync(String)	Écrit de façon asynchrone un commentaire <--...--> contenant le texte spécifié.
WriteDocType(String, String, String, String)	En cas de substitution dans une classe dérivée, écrit la déclaration DOCTYPE avec le nom et les attributs facultatifs spécifiés.
WriteDocTypeAsync(String, String, String, String)	Écrit de façon asynchrone la déclaration DOCTYPE avec le nom spécifié et les attributs facultatifs.
WriteElementString(String, String, String, String)	Écrit un élément avec le préfixe, le nom local, l’URI de l’espace de noms et la valeur spécifiés.
WriteElementString(String, String, String)	Écrit un élément avec le nom local, l’URI de l’espace de noms et la valeur spécifiés.
WriteElementString(String, String)	Écrit un élément avec le nom et la valeur locaux spécifiés.
WriteElementStringAsync(String, String, String, String)	Écrit de façon asynchrone un élément avec le préfixe, le nom local, l’URI d’espace de noms et la valeur spécifiés.
WriteEndAttribute()	En cas de substitution dans une classe dérivée, ferme l’appel précédent WriteStartAttribute(String, String) .
WriteEndAttributeAsync()	Ferme de façon asynchrone l’appel précédent WriteStartAttribute(String, String) .
WriteEndDocument()	En cas de substitution dans une classe dérivée, ferme tous les éléments ou attributs ouverts et place l’enregistreur dans l’état De début.
WriteEndDocumentAsync()	Ferme de manière asynchrone tous les éléments ou attributs ouverts et remet l’enregistreur à l’état De début.
WriteEndElement()	En cas de substitution dans une classe dérivée, ferme un élément et affiche l’étendue d’espace de noms correspondante.
WriteEndElementAsync()	Ferme de façon asynchrone un élément et affiche l’étendue d’espace de noms correspondante.
WriteEntityRef(String)	En cas de substitution dans une classe dérivée, écrit une référence d’entité en tant que &name;.
WriteEntityRefAsync(String)	Écrit de façon asynchrone une référence d’entité en tant que &name;.
WriteFullEndElement()	En cas de substitution dans une classe dérivée, ferme un élément et affiche l’étendue d’espace de noms correspondante.
WriteFullEndElementAsync()	Ferme de façon asynchrone un élément et affiche l’étendue d’espace de noms correspondante.
WriteName(String)	En cas de substitution dans une classe dérivée, écrit le nom spécifié, en s’assurant qu’il s’agit d’un nom valide conformément à la recommandation W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNameAsync(String)	Écrit de façon asynchrone le nom spécifié, en s’assurant qu’il s’agit d’un nom valide conformément à la recommandation W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmToken(String)	En cas de substitution dans une classe dérivée, écrit le nom spécifié, en s’assurant qu’il s’agit d’un NmToken valide conformément à la recommandation W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmTokenAsync(String)	Écrit de façon asynchrone le nom spécifié, en s’assurant qu’il s’agit d’un NmToken valide conformément à la recommandation W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	En cas de substitution dans une classe dérivée, copie tout du lecteur au rédacteur et déplace le lecteur au début du frère suivant.
WriteNode(XPathNavigator, Boolean)	Copie tous les éléments de l’objet XPathNavigator vers l’enregistreur. La position du XPathNavigator reste inchangée.
WriteNodeAsync(XmlReader, Boolean)	Copie de manière asynchrone tout du lecteur vers l’enregistreur et déplace le lecteur au début du frère suivant.
WriteNodeAsync(XPathNavigator, Boolean)	Copie de façon asynchrone tous les éléments de l’objet XPathNavigator vers l’enregistreur. La position du XPathNavigator reste inchangée.
WriteProcessingInstruction(String, String)	En cas de substitution dans une classe dérivée, écrit une instruction de traitement avec un espace entre le nom et le texte comme suit : <?name text ?>.
WriteProcessingInstructionAsync(String, String)	Écrit de façon asynchrone une instruction de traitement avec un espace entre le nom et le texte comme suit : <?name text ?>.
WriteQualifiedName(String, String)	En cas de substitution dans une classe dérivée, écrit le nom qualifié d’espace de noms. Cette méthode recherche le préfixe qui est dans l’étendue de l’espace de noms donné.
WriteQualifiedNameAsync(String, String)	Écrit de façon asynchrone le nom qualifié par l’espace de noms. Cette méthode recherche le préfixe qui est dans l’étendue de l’espace de noms donné.
WriteRaw(Char[], Int32, Int32)	En cas de substitution dans une classe dérivée, écrit manuellement le balisage brut à partir d’une mémoire tampon de caractères.
WriteRaw(String)	En cas de substitution dans une classe dérivée, écrit manuellement le balisage brut à partir d’une chaîne.
WriteRawAsync(Char[], Int32, Int32)	Écrit de façon asynchrone le balisage brut manuellement à partir d’une mémoire tampon de caractères.
WriteRawAsync(String)	Écrit de façon asynchrone le balisage brut manuellement à partir d’une chaîne.
WriteStartAttribute(String, String, String)	En cas de substitution dans une classe dérivée, écrit le début d’un attribut avec le préfixe, le nom local et l’URI d’espace de noms spécifiés.
WriteStartAttribute(String, String)	Écrit le début d’un attribut avec le nom local et l’URI d’espace de noms spécifiés.
WriteStartAttribute(String)	Écrit le début d’un attribut avec le nom local spécifié.
WriteStartAttributeAsync(String, String, String)	Écrit de façon asynchrone le début d’un attribut avec le préfixe, le nom local et l’URI d’espace de noms spécifiés.
WriteStartDocument()	En cas de substitution dans une classe dérivée, écrit la déclaration XML avec la version « 1.0 ».
WriteStartDocument(Boolean)	En cas de substitution dans une classe dérivée, écrit la déclaration XML avec la version « 1.0 » et l’attribut autonome.
WriteStartDocumentAsync()	Écrit de façon asynchrone la déclaration XML avec la version « 1.0 ».
WriteStartDocumentAsync(Boolean)	Écrit de façon asynchrone la déclaration XML avec la version « 1.0 » et l’attribut autonome.
WriteStartElement(String, String, String)	En cas de substitution dans une classe dérivée, écrit la balise de début spécifiée et l’associe à l’espace de noms et au préfixe donnés.
WriteStartElement(String, String)	En cas de substitution dans une classe dérivée, écrit la balise de début spécifiée et l’associe à l’espace de noms donné.
WriteStartElement(String)	En cas de substitution dans une classe dérivée, écrit une balise de début avec le nom local spécifié.
WriteStartElementAsync(String, String, String)	Écrit de façon asynchrone la balise de début spécifiée et l’associe à l’espace de noms et au préfixe donnés.
WriteString(String)	En cas de substitution dans une classe dérivée, écrit le contenu du texte donné.
WriteStringAsync(String)	Écrit de façon asynchrone le contenu du texte donné.
WriteSurrogateCharEntity(Char, Char)	En cas de substitution dans une classe dérivée, génère et écrit l’entité de caractère de substitution pour la paire de caractères de substitution.
WriteSurrogateCharEntityAsync(Char, Char)	Génère et écrit de façon asynchrone l’entité de caractère de substitution pour la paire de caractères de substitution.
WriteValue(Boolean)	Écrit une Boolean valeur.
WriteValue(DateTime)	Écrit une DateTime valeur.
WriteValue(DateTimeOffset)	Écrit une DateTimeOffset valeur.
WriteValue(Decimal)	Écrit une Decimal valeur.
WriteValue(Double)	Écrit une Double valeur.
WriteValue(Int32)	Écrit une Int32 valeur.
WriteValue(Int64)	Écrit une Int64 valeur.
WriteValue(Object)	Écrit la valeur de l’objet.
WriteValue(Single)	Écrit un nombre à virgule flottante simple précision.
WriteValue(String)	Écrit une String valeur.
WriteWhitespace(String)	En cas de substitution dans une classe dérivée, écrit l’espace blanc donné.
WriteWhitespaceAsync(String)	Écrit de façon asynchrone l’espace blanc donné.

Méthodes d’extension

Nom	Description
ConfigureAwait(IAsyncDisposable, Boolean)	Configure la façon dont les attentes sur les tâches retournées à partir d’un jetable asynchrone sont effectuées.

Voir aussi

• Documents et données XML