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

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

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 façon 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