XmlWriter Classe

Définition

Représente un writer qui fournit un moyen rapide, sans mise en cache et en avant de générer des flux de données ou des fichiers contenant des données XML.

public ref class XmlWriter abstract : IDisposable
public ref class XmlWriter abstract : IAsyncDisposable, IDisposable
public ref class XmlWriter abstract
public abstract class XmlWriter : IDisposable
public abstract class XmlWriter : IAsyncDisposable, IDisposable
public abstract class XmlWriter
type XmlWriter = class
    interface IDisposable
type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable
type XmlWriter = class
Public MustInherit Class XmlWriter
Implements IDisposable
Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable
Public MustInherit Class XmlWriter
Héritage
XmlWriter
Dérivé
Implémente

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 lecteur de 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érifier que les caractères sont des caractères XML reconnus et que les noms d'éléments et d'attributs sont des noms XML valides ;

  • vérifier que le document XML est correctement construit ;

  • Encoder les octets binaires en Base64 ou BinHex, puis é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.

  • écrire plusieurs documents dans un même flux de sortie ;

  • écrire des noms, des noms qualifiés et des jetons de nom valides.

Dans cette section :

Création d’un writer XML
Spécification du format de sortie
Conformité des données
Écriture d’éléments
Écriture d’attributs
Gestion des espaces de noms
Écriture de données typées
Fermeture du writer XML
Programmation asynchrone
Considérations relatives à la sécurité

Création d’un writer 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 un 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écification du format de sortie

La XmlWriterSettings classe inclut plusieurs propriétés qui contrôlent la mise XmlWriter en forme de la sortie :

Property Description
Encoding Spécifie l'encodage de texte à utiliser. La valeur par défaut est Encoding.UTF8.
Indent Indique si des éléments doivent être mis en retrait. La valeur par défaut est false (aucune mise en retrait).
IndentChars Spécifie la chaîne de caractères à utiliser pour la mise en retrait. Par défaut, il s'agit de 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).
NewLineHandling Spécifie comment gérer les caractères de nouvelle ligne.
NewLineOnAttributes Indique si des attributs doivent être écrits 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 si une déclaration XML doit être écrite. La valeur par défaut est false.

Les propriétés Indent et IndentChars contrôlent la taille minime de l'espace blanc formaté. 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 pour NewLineOnAttributes écrire chaque attribut sur une nouvelle ligne avec un niveau de retrait supplémentaire :

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 classe pour vérifier la XmlWriterSettings conformité des données :

  • La CheckCharacters propriété indique au writer XML de vérifier les caractères et de lever une XmlException exception si des caractères se trouvent en dehors de la plage légale, comme défini 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 ou d’un fragment de document XML 1.0 bien formé, tels que définis 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 .

    Level 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.

Écriture d’é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.

Utiliser À
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 pour écrire une entité de caractères, WriteAttributeString pour écrire un attribut ou vous pouvez é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 WriteEndElement méthode ou WriteFullEndElement .
WriteNode Pour copier un nœud d’élément trouvé à la position actuelle d’un XmlReader objet ou .XPathNavigator Lorsqu'elle est appelée, elle copie tout l'objet source vers l'instance de l'objet XmlWriter.

Écriture d’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.

Utiliser À
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.

Gestion des espaces de noms

Les espaces de noms sont utilisés pour qualifier des noms d'attributs et d'éléments 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 garantissent l'unicité des noms d'attributs et d'éléments dans un document XML.

gère XmlWriter une pile d’espaces de noms qui correspond à tous les espaces de noms définis dans l’étendue de l’espace de noms actuel. Lors de l'écriture des éléments et attributs, vous pouvez utiliser les espaces de noms comme suit :

  • Déclarez les espaces de noms manuellement à l’aide de la WriteAttributeString méthode . Cela peut s'avérer utile si vous savez comment optimiser le nombre de déclarations d'espaces de noms. Pour obtenir un exemple, consultez la WriteAttributeString(String, String, String, String) méthode .

  • substituer la déclaration d'un nouvel espace de noms à celle de l'espace de noms en cours ; Dans le code suivant, la WriteAttributeString méthode remplace l’URI de l’espace de noms pour le "x" préfixe par "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écifier un préfixe d'espace de noms lors de l'écriture des attributs ou éléments. La plupart des méthodes utilisées pour écrire des éléments et des attributs vous permettent d’effectuer cette opération. 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.

Écriture de 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 type de données XSD (XML Schema Definition Language) et l’é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 les écrire.

Lors de l’écriture dans du 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 .

XmlWriter Peut également être utilisé pour écrire dans un magasin de données XML. Par exemple, la classe XPathNavigator peut créer un objet XmlWriter pour créer des nœuds pour un objet XmlDocument. Si le magasin de données dispose d’informations de schéma, la WriteValue méthode 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, la WriteValue méthode traite toutes les valeurs comme un xsd:anySimpleType type.

Fermeture de l’enregistreur XML

Lorsque vous utilisez des XmlWriter 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 tant que vous ne fermez pas 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 de WriteAttributeString est WriteAttributeStringAsync.

Pour la WriteValue méthode, qui n’a pas d’équivalent asynchrone, convertissez la valeur de retour en chaîne et utilisez la méthode à la WriteStringAsync 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 peuvent divulguer des XmlWriter informations de chemin que vous ne souhaitez pas ajouter à l’application. Votre application doit intercepter les exceptions et les traiter de manière appropriée.

  • XmlWriter ne valide pas les données passées à la WriteDocType méthode ou WriteRaw . Vous ne devez pas passer de données arbitraires à ces méthodes.

Constructeurs

XmlWriter()

Initialise une nouvelle instance de la classe XmlWriter.

Propriétés

Settings

Obtient l'objet XmlWriterSettings permettant de créer cette instance de XmlWriter.

WriteState

En cas de substitution dans une classe dérivée, obtient l'état du writer.

XmlLang

En cas de substitution dans une classe dérivée, obtient la portée xml:lang en cours.

XmlSpace

En cas de substitution dans une classe dérivée, obtient XmlSpace représentant la portée xml:space en cours.

Méthodes

Close()

En cas de substitution dans une classe dérivée, ferme ce flux et le flux sous-jacent.

Create(Stream)

Crée une nouvelle instance de XmlWriter à l'aide du flux spécifié.

Create(Stream, XmlWriterSettings)

Crée une instance de XmlWriter à l'aide du flux et de l'objet XmlWriterSettings.

Create(String)

Crée une instance de XmlWriter à l'aide du nom de fichier spécifié.

Create(String, XmlWriterSettings)

Crée une instance de XmlWriter à l'aide du nom de fichier et de l'objet XmlWriterSettings.

Create(StringBuilder)

Crée une nouvelle instance de XmlWriter à l'aide du StringBuilder spécifié.

Create(StringBuilder, XmlWriterSettings)

Crée une nouvelle instance de XmlWriter à l'aide des objets StringBuilder et XmlWriterSettings.

Create(TextWriter)

Crée une nouvelle instance de XmlWriter à l'aide du TextWriter spécifié.

Create(TextWriter, XmlWriterSettings)

Crée une nouvelle instance de XmlWriter à l'aide des objets TextWriter et XmlWriterSettings.

Create(XmlWriter)

Crée une instance de XmlWriter à l'aide de l'objet XmlWriter spécifié.

Create(XmlWriter, XmlWriterSettings)

Crée une nouvelle instance de XmlWriter à l'aide des objets XmlWriter et XmlWriterSettings spécifiés.

Dispose()

Libère toutes les ressources utilisées par l'instance actuelle de la classe XmlWriter.

Dispose(Boolean)

Libère les ressources non managées utilisées par XmlWriter et libère éventuellement les ressources managées.

DisposeAsync()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition asynchrone des ressources non managées.

DisposeAsyncCore()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition 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 le contenu de la mémoire tampon dans les flux sous-jacents, puis vide le flux sous-jacent.

FlushAsync()

Vide de façon asynchrone le contenu de la mémoire tampon dans les flux sous-jacents, puis vide le flux sous-jacent.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le 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 la portée espace de noms actuelle pour l'URI de l'espace de noms.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(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 XmlReader.

WriteAttributesAsync(XmlReader, Boolean)

Écrit de façon asynchrone tous les attributs trouvés à la position actuelle dans le XmlReader.

WriteAttributeString(String, String)

En cas de substitution dans une classe dérivée, écrit l'attribut avec le nom local 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 de l'espace de noms et la valeur spécifiés.

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 de l'espace de noms et la valeur 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, code les octets binaires spécifiés au format Base64 et écrit le texte obtenu.

WriteBase64Async(Byte[], Int32, Int32)

Encode de façon asynchrone les octets binaires spécifiés au format base64 et écrit le texte résultant.

WriteBinHex(Byte[], Int32, Int32)

En cas de substitution dans une classe dérivée, code les octets binaires spécifiés au format BinHex et écrit le texte obtenu.

WriteBinHexAsync(Byte[], Int32, Int32)

Encode de façon asynchrone les octets binaires spécifiés au format BinHex et écrit le texte résultant.

WriteCData(String)

En cas de substitution dans une classe dérivée, écrit un bloc <![CDATA[...]]> contenant le texte spécifié.

WriteCDataAsync(String)

Écrit de façon asynchrone un bloc <![CDATA[...]]> 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 du 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 du caractère Unicode spécifiée.

WriteChars(Char[], Int32, Int32)

En cas de substitution dans une classe dérivée, écrit du texte mémoire tampon par mémoire tampon.

WriteCharsAsync(Char[], Int32, Int32)

Écrit de façon asynchrone du texte mémoire tampon par mémoire tampon.

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 et les attributs facultatifs spécifiés.

WriteElementString(String, String)

Écrit un élément avec la valeur et le nom locaux 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, String, String)

Écrit un élément avec le préfixe spécifié, le nom local, l'URI de l'espace de noms et la valeur spécifiés.

WriteElementStringAsync(String, String, String, String)

Écrit de façon asynchrone un élément avec le préfixe spécifié, le nom local, l'URI de l'espace de noms et la valeur spécifiés.

WriteEndAttribute()

En cas de substitution dans une classe dérivée, ferme le précédent appel de WriteStartAttribute(String, String).

WriteEndAttributeAsync()

Ferme de façon asynchrone l'appel WriteStartAttribute(String, String) précédent.

WriteEndDocument()

En cas de substitution dans une classe dérivée, ferme les éléments ou attributs ouverts, et replace le writer à l'état Start.

WriteEndDocumentAsync()

Ferme de façon asynchrone les éléments ou attributs ouverts, et replace le writer à l'état Start.

WriteEndElement()

En cas de substitution dans une classe dérivée, ferme un élément et dépile la portée espace de noms correspondante.

WriteEndElementAsync()

Ferme de façon asynchrone un élément et exécute un pop sur la portée espace de noms correspondante.

WriteEntityRef(String)

En cas de substitution dans une classe dérivée, écrit une référence d'entité comme suit : &name;.

WriteEntityRefAsync(String)

Écrit de façon asynchrone une référence d'entité comme suit : &name;.

WriteFullEndElement()

En cas de substitution dans une classe dérivée, ferme un élément et dépile la portée espace de noms correspondante.

WriteFullEndElementAsync()

Ferme de façon asynchrone un élément et exécute un pop sur la portée espace de noms correspondante.

WriteName(String)

En cas de substitution dans une classe dérivée, écrit le nom spécifié, en veillant à ce 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 manière asynchrone le nom spécifié, en veillant à ce 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 veillant à ce 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 manière asynchrone le nom spécifié, en veillant à ce 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 le contenu du lecteur vers le writer, puis déplace le lecteur vers le début du frère suivant.

WriteNode(XPathNavigator, Boolean)

Copie tout de l'objet XPathNavigator vers le writer. La position du XPathNavigator reste inchangée.

WriteNodeAsync(XmlReader, Boolean)

Copie de façon asynchrone tout le contenu du lecteur vers le writer, puis déplace le lecteur vers le début du frère suivant.

WriteNodeAsync(XPathNavigator, Boolean)

Copie de façon asynchrone tout le contenu de l'objet XPathNavigator vers le writer. 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 : <?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é de l'espace de noms. Cette méthode recherche le préfixe situé dans la portée de l'espace de noms spécifié.

WriteQualifiedNameAsync(String, String)

Écrit de façon asynchrone le nom qualifié de l'espace de noms. Cette méthode recherche le préfixe situé dans la portée de l'espace de noms spécifié.

WriteRaw(Char[], Int32, Int32)

En cas de substitution dans une classe dérivée, écrit manuellement un 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 un balisage brut à partir d'une chaîne.

WriteRawAsync(Char[], Int32, Int32)

Écrit manuellement de façon asynchrone un balisage brut à partir d'une mémoire tampon de caractères.

WriteRawAsync(String)

Écrit de façon asynchrone un balisage brut à partir d'une chaîne.

WriteStartAttribute(String)

Écrit le début d'un attribut avec le nom local spécifié.

WriteStartAttribute(String, String)

Écrit le début d'un attribut avec le nom local et l'URI de l'espace de noms spécifiés.

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 de l'espace de noms spécifiés.

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 de l'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)

En cas de substitution dans une classe dérivée, écrit une balise de début avec le nom local spécifié.

WriteStartElement(String, String)

En cas de substitution dans une classe dérivée, écrit l’étiquette de début spécifiée et l’associe à l’espace de noms indiqué.

WriteStartElement(String, String, String)

En cas de substitution dans une classe dérivée, écrit l’étiquette de début spécifiée, puis l’associe à l’espace de noms et au préfixe indiqués.

WriteStartElementAsync(String, String, String)

Écrit de façon asynchrone l’étiquette de début indiquée et l’associe à l’espace de noms et au préfixe spécifiés.

WriteString(String)

En cas de substitution dans une classe dérivée, écrit le texte spécifié.

WriteStringAsync(String)

Écrit de façon asynchrone le texte spécifié.

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 correspondant à la paire de caractères de substitution.

WriteSurrogateCharEntityAsync(Char, Char)

Génère de façon asynchrone et écrit l'entité de caractère de substitution correspondant à la paire de caractères de substitution.

WriteValue(Boolean)

Écrit une valeur Boolean.

WriteValue(DateTime)

Écrit une valeur DateTime.

WriteValue(DateTimeOffset)

Écrit une valeur DateTimeOffset.

WriteValue(Decimal)

Écrit une valeur Decimal.

WriteValue(Double)

Écrit une valeur Double.

WriteValue(Int32)

Écrit une valeur Int32.

WriteValue(Int64)

Écrit une valeur Int64.

WriteValue(Object)

Écrit la valeur de l'objet.

WriteValue(Single)

Écrit un nombre à virgule flottante simple précision.

WriteValue(String)

Écrit une valeur String.

WriteWhitespace(String)

En cas de substitution dans une classe dérivée, écrit l'espace blanc spécifié.

WriteWhitespaceAsync(String)

Écrit de façon asynchrone l'espace blanc spécifié.

Implémentations d’interfaces explicites

IDisposable.Dispose()

Pour obtenir une description de ce membre, consultez Dispose().

Méthodes d’extension

ConfigureAwait(IAsyncDisposable, Boolean)

Configure la façon dont les attentes sur les tâches retournées à partir d’un élément supprimable asynchrone sont effectuées.

S’applique à

Voir aussi