XmlWriter, classe (System.Xml)

Changer de vue:

ScriptFree

Bibliothèque de classes .NET Framework

XmlWriter, classe

Cet article a fait l'objet d'une traduction manuelle. Pour afficher simultanément cette page et le contenu source en anglais, choisissez le paramètre d'affichage Basse densité.

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

Hiérarchie d'héritage

System.Object
  System.Xml.XmlWriter
    System.Xml.XmlDictionaryWriter
    System.Xml.XmlTextWriter
    System.Xml.Xsl.Runtime.XmlQueryOutput

Espace de noms : System.Xml
Assembly : System.Xml (dans System.Xml.dll)

Syntaxe

Visual Basic

Public MustInherit Class XmlWriter _
	Implements IDisposable

public abstract class XmlWriter : IDisposable

VisualC++

public ref class XmlWriter abstract : IDisposable

[<AbstractClass>]
type XmlWriter =  
    class
        interface IDisposable
    end

Le type XmlWriter expose les membres suivants.

Constructeurs

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

Début

Propriétés

	Nom	Description
	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.

Début

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)	Crée une instance de XmlWriter à l'aide du flux spécifié.
	Create(String)	Crée une instance de XmlWriter à l'aide du nom de fichier spécifié.
	Create(StringBuilder)	Crée une instance de XmlWriter à l'aide du StringBuilder spécifié.
	Create(TextWriter)	Crée une instance de XmlWriter à l'aide du TextWriter spécifié.
	Create(XmlWriter)	Crée une instance de XmlWriter à l'aide de l'objet XmlWriter spécifié.
	Create(Stream, XmlWriterSettings)	Crée une instance de XmlWriter à l'aide du flux et de l'objet XmlWriterSettings.
	Create(String, XmlWriterSettings)	Crée une instance de XmlWriter à l'aide du nom de fichier et de l'objet XmlWriterSettings.
	Create(StringBuilder, XmlWriterSettings)	Crée une instance de XmlWriter à l'aide des objets StringBuilder et XmlWriterSettings.
	Create(TextWriter, XmlWriterSettings)	Crée une instance de XmlWriter à l'aide des objets TextWriter et XmlWriterSettings.
	Create(XmlWriter, XmlWriterSettings)	Crée une instance de XmlWriter à l'aide des objets XmlWriter et XmlWriterSettings spécifiés.
	Dispose()
	Dispose(Boolean)	Libère les ressources non managées utilisées par XmlWriter et libère éventuellement les ressources managées.
	Equals(Object)	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (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.
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	LookupPrefix	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 en cours pour l'URI de l'espace de noms.
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
	WriteAttributes	En cas de substitution dans une classe dérivée, écrit tous les attributs trouvés à la position actuelle dans 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.
	WriteBase64	En cas de substitution dans une classe dérivée, encode les octets binaires spécifiés au format Base64 et écrit le texte obtenu.
	WriteBinHex	En cas de substitution dans une classe dérivée, encode les octets binaires spécifiés au format BinHex et écrit le texte obtenu.
	WriteCData	En cas de substitution dans une classe dérivée, écrit un bloc <![CDATA[...]]> contenant le texte spécifié.
	WriteCharEntity	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.
	WriteChars	En cas de substitution dans une classe dérivée, écrit du texte mémoire tampon par mémoire tampon.
	WriteComment	En cas de substitution dans une classe dérivée, écrit un commentaire <!--...--> contenant le texte spécifié.
	WriteDocType	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.
	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 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.
	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.
	WriteEndElement	En cas de substitution dans une classe dérivée, ferme un élément et exécute un pop sur la portée espace de noms correspondante.
	WriteEntityRef	En cas de substitution dans une classe dérivée, écrit 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 exécute un pop sur la portée espace de noms correspondante.
	WriteName	En cas de substitution dans une classe dérivée, écrit le nom spécifié, en vérifiant qu'il s'agit d'un nom valide conformément à la recommandation du W3C intitulée Extensible Markup Language (XML) 1.0 (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
	WriteNmToken	En cas de substitution dans une classe dérivée, écrit le nom spécifié, en vérifiant qu'il s'agit d'un NmToken valide conformément à la recommandation du W3C intitulée Extensible Markup Language (XML) 1.0 (http://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.
	WriteProcessingInstruction	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 : <? nom texte?>.
	WriteQualifiedName	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é.
	WriteRaw(String)	En cas de substitution dans une classe dérivée, écrit manuellement un balisage brut à partir d'une chaîne.
	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.
	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.
	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.
	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 indiqué.
	WriteStartElement(String, String, String)	En cas de substitution dans une classe dérivée, écrit la balise de début spécifiée, puis l'associe à l'espace de noms et au préfixe indiqués.
	WriteString	En cas de substitution dans une classe dérivée, écrit le texte spécifié.
	WriteSurrogateCharEntity	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.
	WriteValue(Boolean)	Écrit une valeur Boolean.
	WriteValue(DateTime)	Écrit une valeur DateTime.
	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	En cas de substitution dans une classe dérivée, écrit l'espace blanc spécifié.

Début

Implémentations d'interface explicite

	Nom	Description
	IDisposable.Dispose	Pour obtenir une description de ce membre, consultez IDisposable.Dispose.

Début

Notes

La classe XmlWriter prend en charge les recommandations du W3C intitulées Extensible Markup Language (XML) 1.0 et Namespaces in XML.

Remarque
Bien que Microsoft .NET Framework inclue la classe XmlTextWriter qui est une implémentation de la classe XmlWriter, dans la version 2.0, nous vous conseillons d'utiliser la méthode Create pour créer des objets XmlWriter. La méthode Create vous permet de spécifier les fonctionnalités à prendre en charge sur l'objet XmlWriter créé ; elle vous permet également de tirer pleinement parti des nouvelles fonctionnalités de la version 2.0.

Remarque

Bien que Microsoft .NET Framework inclue la classe XmlTextWriter qui est une implémentation de la classe XmlWriter, dans la version 2.0, nous vous conseillons d'utiliser la méthode Create pour créer des objets XmlWriter. La méthode Create vous permet de spécifier les fonctionnalités à prendre en charge sur l'objet XmlWriter créé ; elle vous permet également de tirer pleinement parti des nouvelles fonctionnalités de la version 2.0.

Remarque
Lors de l'utilisation des méthodes XmlWriter pour obtenir les informations XML, les éléments et attributs ne sont écrits que lorsque vous appelez la méthode Close. Par exemple, si vous utilisez le XmlWriter pour remplir un XmlDocument, vous ne pouvez pas observer les éléments et les attributs écrits dans le document cible tant que vous n'avez pas fermé le XmlWriter.

Pour plus d'informations sur la classe XmlWriter, consultez Écriture de XML avec XmlWriter.

Considérations à propos de la sécurité

Les éléments suivants sont à prendre en compte lors de l'utilisation de la classe XmlWriter.

Les exceptions levées par le XmlWriter peuvent divulguer des informations relatives au chemin d'accès dont vous ne souhaitez pas qu'elles soient propagées dans l'application. Vos applications doivent intercepter les exceptions et les traiter correctement.
XmlWriter ne valide pas les données qui sont passées aux méthodes WriteDocType ou WriteRaw. Vous ne devez pas passer de données arbitraires à ces méthodes.

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

System.Xml, espace de noms

Autres ressources

Documents et données XML

Sécurité et applications system.xml