Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

XmlWriter, classe

Représente un enregistreur qui offre un moyen rapide, sans mise en cache, avant uniquement pour générer des flux de données ou les fichiers qui contiennent des données XML.

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

public abstract class XmlWriter : IDisposable

Le type XmlWriter expose les membres suivants.

  NomDescription
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreXmlWriterInitialise une nouvelle instance de la classe XmlWriter.
Début

  NomDescription
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSettingsObtient l'objet XmlWriterSettings permettant de créer cette instance de XmlWriter.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStateEn cas de substitution dans une classe dérivée, obtient l'état du writer.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreXmlLangEn cas de substitution dans une classe dérivée, obtient la portée xml:lang en cours.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreXmlSpaceEn cas de substitution dans une classe dérivée, obtient XmlSpace représentant la portée xml:space en cours.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkCloseEn cas de substitution dans une classe dérivée, ferme ce flux et le flux sous-jacent.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(Stream)Crée une nouvelle instance de XmlWriter à l'aide du flux spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkCreate(String)Crée une instance de XmlWriter à l'aide du nom de fichier spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(StringBuilder)Crée une nouvelle instance de XmlWriter à l'aide du StringBuilder spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(TextWriter)Crée une instance de XmlWriter à l'aide du TextWriter spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(XmlWriter)Crée une instance de XmlWriter à l'aide de l'objet XmlWriter spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(Stream, XmlWriterSettings)Crée une instance de XmlWriter à l'aide du flux et de l'objet XmlWriterSettings.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkCreate(String, XmlWriterSettings)Crée une instance de XmlWriter à l'aide du nom de fichier et de l'objet XmlWriterSettings.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(StringBuilder, XmlWriterSettings)Crée une nouvelle instance de XmlWriter à l'aide des objets StringBuilder et XmlWriterSettings.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(TextWriter, XmlWriterSettings)Crée une instance de XmlWriter à l'aide des objets TextWriter et XmlWriterSettings.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreate(XmlWriter, XmlWriterSettings)Crée une nouvelle instance de XmlWriter à l'aide des objets XmlWriter et XmlWriterSettings spécifiés.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDispose()Libère toutes les ressources utilisées par l'instance actuelle de la classe XmlWriter.
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDispose(Boolean)Libère les ressources non managées utilisées par XmlWriter et libère éventuellement les ressources managées.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFlushEn 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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreFlushAsyncVide de façon asynchrone le contenu de la mémoire tampon dans les flux sous-jacents, puis vide le flux sous-jacent.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLookupPrefixEn 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.
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteAttributesEn cas de substitution dans une classe dérivée, écrit tous les attributs trouvés à la position actuelle dans XmlReader.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteAttributesAsyncÉcrit de façon asynchrone tous les attributs trouvés à la position actuelle dans le XmlReader.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteAttributeString(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteAttributeString(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteAttributeString(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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteAttributeStringAsyncÉ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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteBase64En cas de substitution dans une classe dérivée, code les octets binaires spécifiés au format Base64 et écrit le texte obtenu.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteBase64AsyncEncode de façon asynchrone les octets binaires spécifiés au format base64 et écrit le texte résultant.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteBinHexEn cas de substitution dans une classe dérivée, code les octets binaires spécifiés au format BinHex et écrit le texte obtenu.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteBinHexAsyncEncode de façon asynchrone les octets binaires spécifiés au format BinHex et écrit le texte résultant.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteCDataEn cas de substitution dans une classe dérivée, écrit un bloc <![CDATA[...]]> contenant le texte spécifié.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteCDataAsyncÉcrit de façon asynchrone un bloc <![CDATA[…]]> contenant le texte spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteCharEntityEn 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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteCharEntityAsyncForce de façon asynchrone la génération d'une entité de caractère pour la valeur du caractère Unicode spécifiée.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteCharsEn cas de substitution dans une classe dérivée, écrit du texte mémoire tampon par mémoire tampon.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteCharsAsyncÉcrit de façon asynchrone du texte mémoire tampon par mémoire tampon.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteCommentEn cas de substitution dans une classe dérivée, écrit un commentaire <!--...--> contenant le texte spécifié.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteCommentAsyncÉcrit de façon asynchrone un commentaire <!--...--> contenant le texte spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteDocTypeEn cas de substitution dans une classe dérivée, écrit la déclaration DOCTYPE avec le nom et les attributs facultatifs spécifiés.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteDocTypeAsyncÉcrit de façon asynchrone la déclaration DOCTYPE avec le nom et les attributs facultatifs spécifiés.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteElementString(String, String)Écrit un élément avec la valeur et le nom locaux spécifiés.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteElementString(String, String, String)Écrit un élément avec le nom local, l'URI de l'espace de noms et la valeur spécifiés.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteElementString(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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteElementStringAsyncÉ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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteEndAttributeEn cas de substitution dans une classe dérivée, ferme le précédent appel de WriteStartAttribute.
Méthode protégéePris en charge dans .NET pour les applications du Windows StoreWriteEndAttributeAsyncFerme de façon asynchrone l'appel WriteStartAttribute précédent.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteEndDocumentEn cas de substitution dans une classe dérivée, ferme les éléments ou attributs ouverts, et replace le writer à l'état Start.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteEndDocumentAsyncFerme de façon asynchrone les éléments ou attributs ouverts, et replace le writer à l'état Start.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteEndElementEn cas de substitution dans une classe dérivée, ferme un élément et dépile la portée espace de noms correspondante.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteEndElementAsyncFerme de façon asynchrone un élément et exécute un pop sur la portée espace de noms correspondante.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteEntityRefEn cas de substitution dans une classe dérivée, écrit une référence d'entité comme suit : &name;.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteEntityRefAsyncÉcrit de façon asynchrone une référence d'entité comme suit : &name;.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteFullEndElementEn cas de substitution dans une classe dérivée, ferme un élément et dépile la portée espace de noms correspondante.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteFullEndElementAsyncFerme de façon asynchrone un élément et exécute un pop sur la portée espace de noms correspondante.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteNameEn 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).
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteNameAsyncÉcrit de façon asynchrone 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).
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteNmTokenEn 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).
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteNmTokenAsyncÉcrit de façon asynchrone 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).
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteNode(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.
Méthode publiqueWriteNode(XPathNavigator, Boolean)Copie tout de l'objet XPathNavigator vers le writer. La position du XPathNavigator reste inchangée.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteNodeAsync(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.
Méthode publiqueWriteNodeAsync(XPathNavigator, Boolean)Copie de façon asynchrone tout le contenu de l'objet XPathNavigator vers le writer. La position du XPathNavigator reste inchangée.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteProcessingInstructionEn cas de substitution dans une classe dérivée, écrit une instruction de traitement avec un espace entre le nom et le texte : <?nom texte?>.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteProcessingInstructionAsyncÉcrit de façon asynchrone une instruction de traitement avec un espace entre le nom et le texte, comme suit : <?nom texte?>.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteQualifiedNameEn 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é.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteQualifiedNameAsyncÉ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é.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteRaw(String)En cas de substitution dans une classe dérivée, écrit manuellement un balisage brut à partir d'une chaîne.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteRaw(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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteRawAsync(String)Écrit de façon asynchrone un balisage brut à partir d'une chaîne.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteRawAsync(Char[], Int32, Int32)Écrit manuellement de façon asynchrone un balisage brut à partir d'une mémoire tampon de caractères.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStartAttribute(String)Écrit le début d'un attribut avec le nom local spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStartAttribute(String, String)Écrit le début d'un attribut avec le nom local et l'URI de l'espace de noms spécifiés.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStartAttribute(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.
Méthode protégéePris en charge dans .NET pour les applications du Windows StoreWriteStartAttributeAsyncÉ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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStartDocument()En cas de substitution dans une classe dérivée, écrit la déclaration XML avec la version "1.0".
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStartDocument(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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteStartDocumentAsync()Écrit de façon asynchrone la déclaration XML avec la version « 1.0 ».
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteStartDocumentAsync(Boolean)Écrit de façon asynchrone la déclaration XML avec la version « 1.0 » et l'attribut autonome.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStartElement(String)En cas de substitution dans une classe dérivée, écrit une balise de début avec le nom local spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStartElement(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é.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStartElement(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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteStartElementAsyncÉcrit de façon asynchrone la balise de début indiquée et l'associe à l'espace de noms et au préfixe spécifiés.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteStringEn cas de substitution dans une classe dérivée, écrit le texte spécifié.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteStringAsyncÉcrit de façon asynchrone le texte spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteSurrogateCharEntityEn 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.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteSurrogateCharEntityAsyncGénère de façon asynchrone et écrit l'entité de caractère de substitution correspondant à la paire de caractères de substitution.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteValue(Boolean)Écrit une valeur Boolean.
Méthode publiquePris en charge par XNA FrameworkWriteValue(DateTime)Écrit une valeur DateTime.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteValue(DateTimeOffset)Écrit une valeur DateTimeOffset.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteValue(Decimal)Écrit une valeur Decimal.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteValue(Double)Écrit une valeur Double.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteValue(Int32)Écrit une valeur Int32.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteValue(Int64)Écrit une valeur Int64.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteValue(Object)Écrit la valeur de l'objet.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteValue(Single)Écrit un nombre à virgule flottante simple précision.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteValue(String)Écrit une valeur String.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteWhitespaceEn cas de substitution dans une classe dérivée, écrit l'espace blanc spécifié.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteWhitespaceAsyncÉcrit de façon asynchrone l'espace blanc spécifié.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéePris en charge par XNA FrameworkIDisposable.DisposePour obtenir une description de ce membre, consultez IDisposable.Dispose.
Début

La classe d'XmlWriter écrit les données XML dans un flux de données, un fichier, un lecteur de texte, ou en une chaîne. Elle prend en charge les Extensible markup langage (XML) 1,0 (quatrième édition) spécifications W3C et Les espaces de noms dans XML 1,0 (troisième édition) les recommandations.

Les membres de la classe d'XmlWriter permettent :

  • 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 ;

  • Encode les octets binaires comme base64 ou Binhex, puis entrez le texte obtenue.

  • Passer des valeurs à l'aide de les types CLR (common langage runtime) au lieu des chaînes, pour éviter doivent exécuter manuellement les 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éer un enregistreur XML
Spécifier le format de sortie
Conformité de données
Éléments d'écriture
Écrire des attributs
Les espaces de noms de gestion
Données non typées d'écriture
Ferme l'enregistreur XML
Programmation asynchrone
Considérations relatives à la sécurité

Créer un enregistreur XML

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

Spécifier le format de sortie

La classe d'XmlWriterSettings inclut plusieurs propriétés qui contrôlent la manière dont XmlWriter sortie est mis en forme :

Propriété

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

NewLineHandling

Spécifie comment gérer des caractères de saut de ligne.

NewLineOnAttributes

Indique si des attributs doivent être écrits sur une nouvelle ligne. La propriété Indent doit être définie sur true lorsque vous utilisez 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 des nœuds d'élément :


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


Utilisez NewLineOnAttributes pour entrer chaque attribut sur une nouvelle ligne à un coût supplémentaire de la mise en retrait :


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


Conformité de données

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

  • La propriété d'CheckCharacters indique l'enregistreur XML avec des caractères de contrôle et lève une exception d'XmlException si les caractères sont en dehors de la plage légale, comme défini par W3C.

  • La propriété d'ConformanceLevel configure l'enregistreur XML pour vérifier que le flux de données en cours est écrit conformer aux règles pour un document XML bien formées 1,0 ou un fragment de document, comme défini par 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 propriété d'XmlWriterSettings.ConformanceLevel et l'énumération d'System.Xml.ConformanceLevel.

    Niveau

    Description

    Document

    La sortie se conformer aux règles pour un document XML bien formées 1,0 et peut être traité par tout processeur de conformes.

    Fragment

    La sortie se conformer aux règles pour un fragment de document XML bien formées 1,0.

    Auto

    L'enregistreur XML détermine le niveau de conformes vérification pour appliquer (document ou un fragment) sur les données entrantes.

Éléments d'écriture

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

utilisez

Vers

WriteElementString

Entrez un nœud d'élément entier, notamment une valeur de chaîne.

WriteStartElement

Pour entrer une valeur de l'é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 sophistiquée de la méthode d'WriteElementString.

Pour fermer l'élément, vous devez appeler la méthode de WriteEndElement ou d'WriteFullEndElement.

WriteNode

Pour copier un nœud d'élément trouvé à la position actuelle d'un objet d'XmlReader ou d'XPathNavigator. Lorsqu'elle est appelée, elle copie tout l'objet source vers l'instance de l'objet XmlWriter.

Écrire des attributs

Vous pouvez utiliser les méthodes suivantes pour 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'espaces de noms sur un élément, comme décrit dans la section suivante.

utilisez

Vers

WriteAttributeString

Pour entrer un nœud d'attribut entier, notamment une valeur de chaîne.

WriteStartAttribute

Pour entrer la valeur d'attribut à plusieurs appels de méthode. Par exemple, vous pouvez appeler WriteValue pour entrer une valeur non typée. Il s'agit d'une version sophistiquée de la méthode d'WriteElementString.

Pour fermer l'élément, vous devez appeler la méthode de WriteEndAttribute.

WriteAttributes

Pour copier tous les attributs trouvés à la position actuelle d'XmlReader objet. Les attributs qui sont générés dépendent du type de nœud que le lecteur est actuellement positionné sur :

  • Pour un nœud d'attribut, il écrit l'attribut en cours, puis les autres attributs que la balise de fermeture de l'élément.

  • Pour un nœud d'élément, il écrit tous les attributs contenus dans l'élément.

  • Pour un nœud de la déclaration XML, il écrit tous les attributs dans la déclaration.

  • Pour tous les autres types de nœuds, la méthode lève une exception.

Les espaces de noms de gestion

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 les éléments et les attributs avec des espaces de noms, qui est à son tour associé à des références d'URI. Les espaces de noms garantissent l'unicité des noms d'attributs et d'éléments dans un document XML.

XmlWriter contient une pile de l'espace 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 méthode de WriteAttributeString. 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 méthode WriteAttributeString(String, String, String, String).

  • substituer la déclaration d'un nouvel espace de noms à celle de l'espace de noms en cours ; Dans le code suivant, la méthode de WriteAttributeString modifie l'URI d'espace de noms pour le préfixe d'"x" d'"123" à "abc".

    
    writer.WriteStartElement("x", "root", "123");
    writer.WriteStartElement("item");
    writer.WriteAttributeString("xmlns", "x", null, "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. Plusieurs méthodes pour écrire l'élément et les attributs permettent d'effectuer cette opération. Par exemple, la méthode de WriteStartElement(String, String, String) écrit une balise de début et l'associe à un espace de noms et un préfixe spécifié.

Données non typées d'écriture

La méthode d'WriteValue reçoit un objet du common langage runtime (CLR), convertit la valeur d'entrée en sa représentation de chaîne en fonction de les règles de conversion de type de données XSD (XML schema definition langage), ainsi que des écritures il en utilisant la méthode d'WriteString. Il est plus simple que d'utiliser les méthodes de la classe d'XmlConvert pour convertir les données typées en chaîne avant de l'enregistrer.

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

Pour les types de données par défaut XSD correspondant aux types CLR, consultez la méthode d'WriteValue.

XmlWriter peut également être utilisé pour écrire une banque 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 la banque de données contient les informations de schéma disponibles à elle, la méthode de WriteValue lève une exception si vous essayez de conversion en type qui n'est pas autorisé. Si la banque de données ne dispose pas des informations de schéma disponibles à elle, la méthode de WriteValue gère les valeurs comme type d'xsd:anySimpleType.

Ferme l'enregistreur XML

Lorsque vous utilisez des méthodes d'XmlWriter de sortie XML, les éléments et les attributs ne sont pas fournis jusqu'à ce que vous appeliez la méthode d'Close. Par exemple, si vous utilisez XmlWriter pour remplir un objet d'XmlDocument, vous ne pouvez pas afficher les éléments et les attributs fournis dans le document cible jusqu'à ce que vous clôturiez l'instance de XmlWriter.

Programmation asynchrone

La plupart des méthodes d'XmlWriter ont des équivalents asynchrone ayant « Asynchrone » à la fin de le nom de méthode. Par exemple, l'équivalent asynchrone d'WriteAttributeString est WriteAttributeStringAsync.

Pour la méthode d'WriteValue, qui n'a pas d'équivalent asynchrones, ne convertit pas la valeur de retour d'une chaîne et non la méthode d'WriteStringAsync à la place.

Considérations relatives à la sécurité

Tenez compte des points suivants lorsque vous utilisez la classe d'XmlWriter :

  • Les exceptions levées par XmlWriter peuvent divulgation les informations de chemin d'accès que vous ne souhaitez pas bouillonné jusqu'à l'application. Votre application doit intercepter les exceptions et les traiter correctement.

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

Le code exemple 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();
    }
}

.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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.

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft