XmlWriter Classe

Définition

Espace de noms:

System.Xml

Assembly:

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

Pour plus d’informations sur cette API, consultez remarques d’API supplémentaires pour XmlWriter.

Constructeurs

XmlWriter()

Initialise une nouvelle instance de la classe XmlWriter.

Propriétés

Settings	Obtient l’objet XmlWriterSettings utilisé pour créer cette instance XmlWriter.
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 xml:lang actuelle.
XmlSpace	En cas de substitution dans une classe dérivée, obtient une XmlSpace représentant l’étendue de xml:space actuelle.

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 instance XmlWriter à l’aide du flux spécifié.
Create(Stream, XmlWriterSettings)	Crée une instance XmlWriter à l’aide du flux et de l’objet XmlWriterSettings.
Create(String)	Crée une instance XmlWriter à l’aide du nom de fichier spécifié.
Create(String, XmlWriterSettings)	Crée une instance XmlWriter à l’aide du nom de fichier et de l’objet XmlWriterSettings.
Create(StringBuilder)	Crée une instance XmlWriter à l’aide de la StringBuilderspécifiée.
Create(StringBuilder, XmlWriterSettings)	Crée une instance XmlWriter à l’aide des objets StringBuilder et XmlWriterSettings.
Create(TextWriter)	Crée une instance XmlWriter à l’aide de la TextWriterspécifiée.
Create(TextWriter, XmlWriterSettings)	Crée une instance XmlWriter à l’aide des objets TextWriter et XmlWriterSettings.
Create(XmlWriter)	Crée une instance XmlWriter à l’aide de l’objet XmlWriter spécifié.
Create(XmlWriter, XmlWriterSettings)	Crée une instance 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 le XmlWriter 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)	En cas de substitution dans une classe dérivée, écrit l’attribut avec le nom et la valeur locaux 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, 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.
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 en tant que BinHex et écrit le texte résultant.
WriteBinHexAsync(Byte[], Int32, Int32)	Encode de manière asynchrone les octets binaires spécifiés en tant que BinHex et écrit le texte résultant.
WriteCData(String)	En cas de substitution dans une classe dérivée, écrit une <! [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)	Écrit un élément avec le nom et la valeur 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, 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, 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 WriteStartAttribute(String, String) précédent.
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 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 veillant à ce qu’il soit 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 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)	É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 d’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 d’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 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)	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 la balise de début spécifiée et l’associe à l’espace de noms donné.
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.
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 de 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 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 donné.
WriteWhitespaceAsync(String)	Écrit de façon asynchrone l’espace blanc donné.

Méthodes d’extension

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 XML et de données