Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlTextWriter classe

 

Date de publication : novembre 2016

Représente un writer qui fournit un moyen rapide, non mis en cache et avant uniquement de générer des flux ou des fichiers contenant des données XML conforme au W3C Extensible Markup Language (XML) 1.0 et les espaces de noms dans les recommandations de XML.

À compter de .NET Framework 2.0, nous vous recommandons d'utiliser plutôt la classe System.Xml::XmlWriter.

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

System::Object
  System.Xml::XmlWriter
    System.Xml::XmlTextWriter

public ref class XmlTextWriter : XmlWriter

NomDescription
System_CAPS_pubmethodXmlTextWriter(Stream^, Encoding^)

Crée une instance de la XmlTextWriter de classe à l’aide du flux spécifié et de codage.

System_CAPS_pubmethodXmlTextWriter(String^, Encoding^)

Crée une instance de la XmlTextWriter classe à l’aide du fichier spécifié.

System_CAPS_pubmethodXmlTextWriter(TextWriter^)

Crée une instance de la XmlTextWriter classe à l’aide du TextWriter.

NomDescription
System_CAPS_pubpropertyBaseStream

Obtient l'objet de flux sous-jacent.

System_CAPS_pubpropertyFormatting

Indique la façon dont la sortie est mise en forme.

System_CAPS_pubpropertyIndentation

Obtient ou définit le nombre d’IndentChars à écrire pour chaque niveau dans la hiérarchie lorsque Formatting a la valeur Formatting.Indented.

System_CAPS_pubpropertyIndentChar

Obtient ou définit le caractère à utiliser pour la mise en retrait lorsque Formatting a la valeur Formatting.Indented.

System_CAPS_pubpropertyNamespaces

Obtient ou définit une valeur indiquant si la prise en charge des espaces de noms doit être assurée ou non.

System_CAPS_pubpropertyQuoteChar

Obtient ou définit le caractère à utiliser pour mettre les valeurs d'attributs entre guillemets.

System_CAPS_pubpropertySettings

Obtient l'objet XmlWriterSettings permettant de créer cette instance de XmlWriter.(Hérité de XmlWriter.)

System_CAPS_pubpropertyWriteState

Obtient l'état du writer.(Remplace XmlWriter::WriteState.)

System_CAPS_pubpropertyXmlLang

Obtient la portée de xml:lang actuelle.(Remplace XmlWriter::XmlLang.)

System_CAPS_pubpropertyXmlSpace

Obtient un XmlSpace représentant actuel xml:space étendue.(Remplace XmlWriter::XmlSpace.)

NomDescription
System_CAPS_pubmethodClose()

Ferme ce flux et le flux sous-jacent.(Remplace XmlWriter::Close().)

System_CAPS_pubmethodDispose()

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

System_CAPS_protmethodDispose(Boolean)

Libère les ressources non managées utilisées par XmlWriter et libère éventuellement les ressources managées.(Hérité de XmlWriter.)

System_CAPS_pubmethodEquals(Object^)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

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

System_CAPS_pubmethodFlush()

Vide le contenu de la mémoire tampon dans les flux sous-jacents, puis vide le flux sous-jacent.(Remplace XmlWriter::Flush().)

System_CAPS_pubmethodFlushAsync()

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

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodLookupPrefix(String^)

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.(Remplace XmlWriter::LookupPrefix(String^).)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodWriteAttributes(XmlReader^, Boolean)

En cas de substitution dans une classe dérivée, écrit tous les attributs trouvés à la position actuelle dans le XmlReader.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteAttributesAsync(XmlReader^, Boolean)

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

System_CAPS_pubmethodWriteAttributeString(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteAttributeString(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteAttributeString(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteAttributeStringAsync(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteBase64(array<Byte>^, Int32, Int32)

Encode les octets binaires spécifiés au format base64 et écrit le texte résultant.(Remplace XmlWriter::WriteBase64(array<Byte>^, Int32, Int32).)

System_CAPS_pubmethodWriteBase64Async(array<Byte>^, Int32, Int32)

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

System_CAPS_pubmethodWriteBinHex(array<Byte>^, Int32, Int32)

Encode les octets binaires spécifiés au format binhex et écrit le texte résultant.(Remplace XmlWriter::WriteBinHex(array<Byte>^, Int32, Int32).)

System_CAPS_pubmethodWriteBinHexAsync(array<Byte>^, Int32, Int32)

Encode les octets binaires spécifiés en tant que de façon asynchrone BinHex et écrit le texte résultant.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteCData(String^)

Écrit un bloc <![CDATA[...]]> contenant le texte spécifié.(Remplace XmlWriter::WriteCData(String^).)

System_CAPS_pubmethodWriteCDataAsync(String^)

Écrit de façon asynchrone un bloc <![CDATA[…]]> contenant le texte spécifié.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteCharEntity(Char)

Force la génération d'une entité de caractère pour la valeur du caractère Unicode spécifiée.(Remplace XmlWriter::WriteCharEntity(Char).)

System_CAPS_pubmethodWriteCharEntityAsync(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteChars(array<Char>^, Int32, Int32)

Écrit du texte mémoire tampon par mémoire tampon.(Remplace XmlWriter::WriteChars(array<Char>^, Int32, Int32).)

System_CAPS_pubmethodWriteCharsAsync(array<Char>^, Int32, Int32)

Écrit de façon asynchrone du texte mémoire tampon par mémoire tampon.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteComment(String^)

Écrit un commentaire <!--...--> contenant le texte spécifié.(Remplace XmlWriter::WriteComment(String^).)

System_CAPS_pubmethodWriteCommentAsync(String^)

Écrit de façon asynchrone un commentaire <!--...--> contenant le texte spécifié.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteDocType(String^, String^, String^, String^)

Écrit la déclaration DOCTYPE avec le nom et les attributs facultatifs spécifiés.(Remplace XmlWriter::WriteDocType(String^, String^, String^, String^).)

System_CAPS_pubmethodWriteDocTypeAsync(String^, String^, String^, String^)

Écrit de façon asynchrone la déclaration DOCTYPE avec le nom et les attributs facultatifs spécifiés.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteElementString(String^, String^)

Écrit un élément avec la valeur et le nom locaux spécifiés.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteElementString(String^, String^, String^)

Écrit un élément avec le nom local, l'URI de l'espace de noms et la valeur spécifiés.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteElementString(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteElementStringAsync(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteEndAttribute()

Ferme le précédent WriteStartAttribute appeler.(Remplace XmlWriter::WriteEndAttribute().)

System_CAPS_protmethodWriteEndAttributeAsync()

Ferme de façon asynchrone le précédent WriteStartAttribute appeler.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteEndDocument()

Ferme les éléments ou attributs ouverts, et replace le writer à l'état Start.(Remplace XmlWriter::WriteEndDocument().)

System_CAPS_pubmethodWriteEndDocumentAsync()

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

System_CAPS_pubmethodWriteEndElement()

Ferme un élément et exécute un pop sur la portée espace de noms correspondante.(Remplace XmlWriter::WriteEndElement().)

System_CAPS_pubmethodWriteEndElementAsync()

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

System_CAPS_pubmethodWriteEntityRef(String^)

Écrit une référence d’entité en tant que &name;.(Remplace XmlWriter::WriteEntityRef(String^).)

System_CAPS_pubmethodWriteEntityRefAsync(String^)

Écrit de façon asynchrone une référence d’entité en tant que &name;.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteFullEndElement()

Ferme un élément et exécute un pop sur la portée espace de noms correspondante.(Remplace XmlWriter::WriteFullEndElement().)

System_CAPS_pubmethodWriteFullEndElementAsync()

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

System_CAPS_pubmethodWriteName(String^)

É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).(Remplace XmlWriter::WriteName(String^).)

System_CAPS_pubmethodWriteNameAsync(String^)

É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).(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteNmToken(String^)

Écrit le nom spécifié, en vérifiant qu’il n’est valide NmToken selon la recommandation W3C XML 1.0 (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).(Remplace XmlWriter::WriteNmToken(String^).)

System_CAPS_pubmethodWriteNmTokenAsync(String^)

É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).(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteNode(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteNode(XPathNavigator^, Boolean)

Copie tout de le XPathNavigator l’objet vers le writer. La position de la XPathNavigator reste inchangé.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteNodeAsync(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteNodeAsync(XPathNavigator^, Boolean)

Copie tous les éléments à partir de façon asynchrone le XPathNavigator objet vers le writer. La position de la XPathNavigator reste inchangé.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteProcessingInstruction(String^, String^)

Écrit une instruction de traitement avec un espace entre le nom et le texte comme suit : < ? nom texte ? >.(Remplace XmlWriter::WriteProcessingInstruction(String^, String^).)

System_CAPS_pubmethodWriteProcessingInstructionAsync(String^, String^)

Écrit de façon asynchrone une instruction de traitement avec un espace entre le nom et le texte comme suit : < ? nom texte ? >.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteQualifiedName(String^, String^)

É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é.(Remplace XmlWriter::WriteQualifiedName(String^, String^).)

System_CAPS_pubmethodWriteQualifiedNameAsync(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é.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteRaw(array<Char>^, Int32, Int32)

Écrit manuellement un balisage brut à partir d'une mémoire tampon de caractères.(Remplace XmlWriter::WriteRaw(array<Char>^, Int32, Int32).)

System_CAPS_pubmethodWriteRaw(String^)

Écrit manuellement un balisage brut à partir d'une chaîne.(Remplace XmlWriter::WriteRaw(String^).)

System_CAPS_pubmethodWriteRawAsync(array<Char>^, Int32, Int32)

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

System_CAPS_pubmethodWriteRawAsync(String^)

Écrit de façon asynchrone un balisage brut à partir d'une chaîne.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteStartAttribute(String^)

Écrit le début d'un attribut avec le nom local spécifié.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteStartAttribute(String^, String^)

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

System_CAPS_pubmethodWriteStartAttribute(String^, String^, String^)

Écrit le début d'un attribut.(Remplace XmlWriter::WriteStartAttribute(String^, String^, String^).)

System_CAPS_protmethodWriteStartAttributeAsync(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteStartDocument()

Écrit la déclaration XML avec la version "1.0".(Remplace XmlWriter::WriteStartDocument().)

System_CAPS_pubmethodWriteStartDocument(Boolean)

Écrit la déclaration XML avec la version "1.0" et l'attribut autonome.(Remplace XmlWriter::WriteStartDocument(Boolean).)

System_CAPS_pubmethodWriteStartDocumentAsync()

Écrit de façon asynchrone la déclaration XML avec la version « 1.0 ».(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteStartDocumentAsync(Boolean)

Écrit de façon asynchrone la déclaration XML avec la version « 1.0 » et l'attribut autonome.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteStartElement(String^)

En cas de substitution dans une classe dérivée, écrit une étiquette de début avec le nom local spécifié.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteStartElement(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é.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteStartElement(String^, String^, String^)

Écrit l’étiquette de début indiquée et l’associe à l’espace de noms et au préfixe spécifiés.(Remplace XmlWriter::WriteStartElement(String^, String^, String^).)

System_CAPS_pubmethodWriteStartElementAsync(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteString(String^)

Écrit le texte spécifié.(Remplace XmlWriter::WriteString(String^).)

System_CAPS_pubmethodWriteStringAsync(String^)

Écrit de façon asynchrone le texte spécifié.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteSurrogateCharEntity(Char, Char)

Génère et écrit l'entité de caractère de substitution correspondant à la paire de caractères de substitution.(Remplace XmlWriter::WriteSurrogateCharEntity(Char, Char).)

System_CAPS_pubmethodWriteSurrogateCharEntityAsync(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.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(Boolean)

Écrit une valeur Boolean.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(DateTime)

Écrit une valeur DateTime.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(DateTimeOffset)

Écrit une valeur DateTimeOffset.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(Decimal)

Écrit une valeur Decimal.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(Double)

Écrit une valeur Double.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(Int32)

Écrit une valeur Int32.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(Int64)

Écrit une valeur Int64.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(Object^)

Écrit la valeur de l'objet.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(Single)

Écrit un nombre à virgule flottante simple précision.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteValue(String^)

Écrit une valeur String.(Hérité de XmlWriter.)

System_CAPS_pubmethodWriteWhitespace(String^)

Écrit l'espace blanc spécifié(Remplace XmlWriter::WriteWhitespace(String^).)

System_CAPS_pubmethodWriteWhitespaceAsync(String^)

Écrit de façon asynchrone l'espace blanc spécifié.(Hérité de XmlWriter.)

Cette classe implémente la XmlWriter classe.

System_CAPS_noteRemarque

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlWriter instances à l’aide de la XmlWriter::Create méthode et la XmlWriterSettings classe pour tirer parti des nouvelles fonctionnalités.

XmlTextWriter conserve une pile d’espace de noms correspondant à tous les espaces de noms définis dans la pile d’éléments en cours. À l’aide de XmlTextWriter vous pouvez déclarer des espaces de noms manuellement.

w.WriteStartElement("root");
w.WriteAttributeString("xmlns", "x", null, "urn:1");
 w.WriteStartElement("item","urn:1");
 w.WriteEndElement();
 w.WriteStartElement("item","urn:1");
 w.WriteEndElement();
w.WriteEndElement();

Le code c# ci-dessus génère la sortie suivante. XmlTextWriter promeut la déclaration d’espace de noms à l’élément racine pour éviter de dupliquer sur les deux éléments enfants. Les éléments enfants récupèrent le préfixe de la déclaration d’espace de noms.

<root xmlns:x="urn:1">
 <x:item/>
 <x:item/>
</x:root>

XmlTextWriter vous permet également de substituer la déclaration d’espace de noms en cours. Dans l’exemple suivant, l’espace de noms URI « 123 » est remplacé par « abc » pour produire l’élément XML <x:node xmlns:x="abc"/>.

w.WriteStartElement("x","node","123");
w.WriteAttributeString("xmlns","x",null,"abc");

En utilisant les méthodes d’écriture qui prennent un préfixe comme argument, vous pouvez également spécifier quel préfixe pour utiliser. Dans l’exemple suivant, deux préfixes différents sont mappés au même espace de noms URI pour produire le texte XML <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>.

XmlTextWriter w = new XmlTextWriter(Console.Out);
w.WriteStartElement("x","root","urn:1");
 w.WriteStartElement("y","item","urn:1");
 w.WriteEndElement();
w.WriteEndElement();
w.Close();

Si plusieurs déclarations d’espace de noms mappent différents préfixes au même espace de noms URI, XmlTextWriter parcourt la pile de déclarations d’espace de noms vers l’arrière et récupère la plus proche.

XmlTextWriter w = new XmlTextWriter(Console.Out);
w.Formatting = Formatting.Indented;
w.WriteStartElement("x","root","urn:1");
w.WriteStartElement("y","item","urn:1");
w.WriteAttributeString("attr","urn:1","123");
w.WriteEndElement();
w.WriteEndElement();
w.Close();

Dans l’exemple c# ci-dessus, car le WriteAttributeString appel ne spécifie pas de préfixe, le writer utilise le dernier préfixe vers la pile de l’espace de noms et génère le code XML suivant :

<x:root xmlns:x="urn:1">
 <y:item y:attr="123" xmlns:y="urn:1" />
</x:root>

En cas de conflits d’espace de noms, XmlTextWriter les résout en générant des préfixes de remplacement. Par exemple, si un attribut et élément ont le même préfixe mais des espaces de noms, XmlWriter génère un préfixe de remplacement pour l’attribut. Les préfixes générés sont nommés n{i}i est un nombre commençant à 1. Le nombre est réinitialisé à 1 pour chaque élément.

Les attributs qui sont associés à un URI d’espace de noms doivent avoir un préfixe (espaces de noms ne s’appliquent pas aux attributs de valeur par défaut). Cette opération est conforme à la section 5.2 des espaces de noms W3C dans la recommandation XML. Si un attribut fait référence à un URI d’espace de noms, mais ne spécifie pas de préfixe, le writer génère un préfixe pour l’attribut.

Lors de l’écriture d’un élément vide, un espace supplémentaire est ajouté entre le nom de la balise et la balise de fermeture, par exemple <item />. Cela assure la compatibilité avec les navigateurs plus anciens.

Lorsqu’un String est utilisé en tant que paramètre de méthode, null et String.Empty sont équivalentes. String.Empty suit les règles W3C.

Pour écrire des données fortement typées, utilisez la XmlConvert classe pour convertir des types de données chaîne. Par exemple, le code c# suivant convertit les données à partir de Double à String et écrit l’élément <price>19.95</price>.

Double price = 19.95;
writer.WriteElementString("price", XmlConvert.ToString(price));

XmlTextWriter ne vérifie pas les éléments suivants :

  • Caractères non valides dans les noms d’élément et d’attribut.

  • Caractères Unicode qui ne correspondent pas au codage spécifié. Si les caractères Unicode ne correspondent pas à l’encodage spécifié, le XmlTextWriter n’échappe pas les caractères Unicode dans les entités de caractères.

  • Attributs en double.

  • Caractères de l’identificateur public DOCTYPE ou l’identificateur de système.

Les éléments suivants sont à prendre en compte lorsque vous travaillez avec la XmlTextWriter classe.

  • Les exceptions levées par le XmlTextWriter peut divulguer des informations de chemin d’accès que vous ne souhaitez pas propagées dans l’application. Vos applications doivent intercepter les exceptions et les traiter correctement.

  • Lorsque vous transmettez l'objet XmlTextWriter à une autre application, le flux sous-jacent est exposé à cette application. Si vous devez transmettre XmlTextWriter à une application partiellement fiable, vous devez plutôt utiliser un objet XmlWriter créé par la méthode Create.

  • Le XmlTextWriter ne valide pas les données qui sont transmises à la WriteDocType ou WriteRaw méthodes. Vous ne devez pas passer des données arbitraires à ces méthodes.

  • Si les paramètres par défaut sont modifiées, il n’est pas garanti que la sortie générée est données XML bien formées.

  • N’acceptez pas les composants de prise en charge, tel qu’une Encoding objet, à partir d’une source non fiable.

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: