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

XmlTextWriter, classe

Représente un writer qui fournit un procédé rapide, sans mise en cache et en avant uniquement de génération de flux de fichiers contenant des données XML ; ce procédé est conforme aux recommandations du W3C intitulées Extensible Markup Language (XML) 1.0 et Namespace in XML.

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

public ref class XmlTextWriter : public XmlWriter

Le type XmlTextWriter expose les membres suivants.

  NomDescription
Méthode publiquePris en charge par XNA FrameworkXmlTextWriter(TextWriter)Crée une instance de la classe XmlTextWriter à l'aide du TextWriter spécifié.
Méthode publiquePris en charge par XNA FrameworkXmlTextWriter(Stream, Encoding)Crée une instance de la classe XmlTextWriter à l'aide du flux et de l'encodage spécifiés.
Méthode publiquePris en charge par XNA FrameworkXmlTextWriter(String, Encoding)Crée une instance de la classe XmlTextWriter à l'aide du fichier spécifié.
Début

  NomDescription
Propriété publiquePris en charge par XNA FrameworkBaseStreamObtient l'objet de flux sous-jacent.
Propriété publiquePris en charge par XNA FrameworkFormattingIndique la façon dont la sortie est mise en forme.
Propriété publiquePris en charge par XNA FrameworkIndentationObtient ou définit le nombre d'IndentChars à écrire pour chaque niveau de la hiérarchie lorsque Formatting a la valeur Formatting.Indented.
Propriété publiquePris en charge par XNA FrameworkIndentCharObtient ou définit le caractère à utiliser pour la mise en retrait lorsque Formatting a la valeur Formatting.Indented.
Propriété publiquePris en charge par XNA FrameworkNamespacesObtient ou définit une valeur indiquant si la prise en charge des espaces de noms doit être assurée ou non.
Propriété publiquePris en charge par XNA FrameworkQuoteCharObtient ou définit le caractère à utiliser pour mettre les valeurs d'attributs entre guillemets.
Propriété publiquePris en charge par XNA FrameworkSettingsObtient l'objet XmlWriterSettings permettant de créer cette instance de XmlWriter. (Hérité de XmlWriter.)
Propriété publiquePris en charge par XNA FrameworkWriteStateObtient l'état du writer. (Substitue XmlWriter::WriteState.)
Propriété publiquePris en charge par XNA FrameworkXmlLangObtient la portée xml:lang en cours. (Substitue XmlWriter::XmlLang.)
Propriété publiquePris en charge par XNA FrameworkXmlSpaceObtient un XmlSpace représentant la portée xml:space en cours. (Substitue XmlWriter::XmlSpace.)
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkCloseFerme ce flux et le flux sous-jacent. (Substitue XmlWriter::Close().)
Méthode publiqueDispose()Libère toutes les ressources utilisées par l'instance actuelle de la classe XmlWriter. (Hérité de XmlWriter.)
Méthode protégéePris en charge par XNA FrameworkDispose(Boolean)Libère les ressources non managées utilisées par XmlWriter et libère éventuellement les ressources managées. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkEquals(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 FrameworkFinalize 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 FrameworkFlushVide le contenu de la mémoire tampon dans les flux sous-jacents, puis vide le flux sous-jacent. (Substitue XmlWriter::Flush().)
Méthode publiqueFlushAsyncVide 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.)
Méthode publiquePris en charge par XNA FrameworkGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkLookupPrefixRetourne 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. (Substitue XmlWriter::LookupPrefix(String).)
Méthode protégéePris en charge par XNA FrameworkMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkWriteAttributesEn cas de substitution dans une classe dérivée, écrit tous les attributs trouvés à la position actuelle dans XmlReader. (Hérité de XmlWriter.)
Méthode publiqueWriteAttributesAsyncÉcrit de façon asynchrone tous les attributs trouvés à la position actuelle dans le XmlReader. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteAttributeString(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.)
Méthode publiquePris en charge par XNA FrameworkWriteAttributeString(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.)
Méthode publiquePris en charge par XNA FrameworkWriteAttributeString(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.)
Méthode publiqueWriteAttributeStringAsyncÉ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.)
Méthode publiquePris en charge par XNA FrameworkWriteBase64Encode les octets binaires spécifiés au format base64 et écrit le texte résultant. (Substitue XmlWriter::WriteBase64(array<Byte>, Int32, Int32).)
Méthode publiqueWriteBase64AsyncEncode de façon asynchrone les octets binaires spécifiés au format base64 et écrit le texte résultant. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteBinHexEncode les octets binaires spécifiés au format binhex et écrit le texte résultant. (Substitue XmlWriter::WriteBinHex(array<Byte>, Int32, Int32).)
Méthode publiqueWriteBinHexAsyncEncode de façon asynchrone les octets binaires spécifiés au format BinHex et écrit le texte résultant. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteCDataةcrit un bloc <![CDATA[...]]> contenant le texte spécifié. (Substitue XmlWriter::WriteCData(String).)
Méthode publiqueWriteCDataAsyncÉcrit de façon asynchrone un bloc <![CDATA[…]]> contenant le texte spécifié. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteCharEntityForce la génération d'une entité de caractère pour la valeur du caractère Unicode spécifiée. (Substitue XmlWriter::WriteCharEntity(Char).)
Méthode publiqueWriteCharEntityAsyncForce 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.)
Méthode publiquePris en charge par XNA FrameworkWriteCharsةcrit du texte mémoire tampon par mémoire tampon. (Substitue XmlWriter::WriteChars(array<Char>, Int32, Int32).)
Méthode publiqueWriteCharsAsyncÉcrit de façon asynchrone du texte mémoire tampon par mémoire tampon. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteCommentةcrit un commentaire <!--...--> contenant le texte spécifié. (Substitue XmlWriter::WriteComment(String).)
Méthode publiqueWriteCommentAsyncÉcrit de façon asynchrone un commentaire <!--...--> contenant le texte spécifié. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteDocTypeةcrit la déclaration DOCTYPE avec le nom et les attributs facultatifs spécifiés. (Substitue XmlWriter::WriteDocType(String, String, String, String).)
Méthode publiqueWriteDocTypeAsyncÉcrit de façon asynchrone la déclaration DOCTYPE avec le nom et les attributs facultatifs spécifiés. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteElementString(String, String)Écrit un élément avec la valeur et le nom locaux spécifiés. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteElementString(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.)
Méthode publiquePris en charge par XNA FrameworkWriteElementString(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.)
Méthode publiqueWriteElementStringAsyncÉ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.)
Méthode publiquePris en charge par XNA FrameworkWriteEndAttributeFerme le précédent appel de WriteStartAttribute. (Substitue XmlWriter::WriteEndAttribute().)
Méthode protégéeWriteEndAttributeAsyncFerme de façon asynchrone l'appel WriteStartAttribute précédent. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteEndDocumentFerme les éléments ou attributs ouverts, et replace le writer à l'état Start. (Substitue XmlWriter::WriteEndDocument().)
Méthode publiqueWriteEndDocumentAsyncFerme de façon asynchrone les éléments ou attributs ouverts, et replace le writer à l'état Start. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteEndElementFerme un élément et exécute un pop sur la portée espace de noms correspondante. (Substitue XmlWriter::WriteEndElement().)
Méthode publiqueWriteEndElementAsyncFerme de façon asynchrone un élément et exécute un pop sur la portée espace de noms correspondante. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteEntityRefةcrit une référence d'entité comme suit : &name;. (Substitue XmlWriter::WriteEntityRef(String).)
Méthode publiqueWriteEntityRefAsyncÉcrit de façon asynchrone une référence d'entité comme suit : &name;. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteFullEndElementFerme un élément et exécute un pop sur la portée espace de noms correspondante. (Substitue XmlWriter::WriteFullEndElement().)
Méthode publiqueWriteFullEndElementAsyncFerme de façon asynchrone un élément et exécute un pop sur la portée espace de noms correspondante. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteNameة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). (Substitue XmlWriter::WriteName(String).)
Méthode publiqueWriteNameAsyncÉ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.)
Méthode publiquePris en charge par XNA FrameworkWriteNmTokenة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). (Substitue XmlWriter::WriteNmToken(String).)
Méthode publiqueWriteNmTokenAsyncÉ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.)
Méthode publiquePris en charge par XNA FrameworkWriteNode(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.)
Méthode publiqueWriteNode(XPathNavigator, Boolean)Copie tout de l'objet XPathNavigator vers le writer. La position du XPathNavigator reste inchangée. (Hérité de XmlWriter.)
Méthode publiqueWriteNodeAsync(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.)
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. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteProcessingInstructionÉcrit une instruction de traitement avec un espace entre le nom et le texte, comme suit : <? nom texte?>. (Substitue XmlWriter::WriteProcessingInstruction(String, String).)
Méthode publiqueWriteProcessingInstructionAsyncÉ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.)
Méthode publiquePris en charge par XNA FrameworkWriteQualifiedNameة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é. (Substitue XmlWriter::WriteQualifiedName(String, String).)
Méthode publiqueWriteQualifiedNameAsyncÉ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.)
Méthode publiquePris en charge par XNA FrameworkWriteRaw(String)ةcrit manuellement un balisage brut à partir d'une chaîne. (Substitue XmlWriter::WriteRaw(String).)
Méthode publiquePris en charge par XNA FrameworkWriteRaw(array<Char>, Int32, Int32)ةcrit manuellement un balisage brut à partir d'une mémoire tampon de caractères. (Substitue XmlWriter::WriteRaw(array<Char>, Int32, Int32).)
Méthode publiqueWriteRawAsync(String)Écrit de façon asynchrone un balisage brut à partir d'une chaîne. (Hérité de XmlWriter.)
Méthode publiqueWriteRawAsync(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.)
Méthode publiquePris en charge par XNA FrameworkWriteStartAttribute(String)Écrit le début d'un attribut avec le nom local spécifié. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteStartAttribute(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.)
Méthode publiquePris en charge par XNA FrameworkWriteStartAttribute(String, String, String)ةcrit le début d'un attribut. (Substitue XmlWriter::WriteStartAttribute(String, String, String).)
Méthode protégéeWriteStartAttributeAsyncÉ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.)
Méthode publiquePris en charge par XNA FrameworkWriteStartDocument()ةcrit la déclaration XML avec la version "1.0". (Substitue XmlWriter::WriteStartDocument().)
Méthode publiquePris en charge par XNA FrameworkWriteStartDocument(Boolean)ةcrit la déclaration XML avec la version "1.0" et l'attribut autonome. (Substitue XmlWriter::WriteStartDocument(Boolean).)
Méthode publiqueWriteStartDocumentAsync()Écrit de façon asynchrone la déclaration XML avec la version « 1.0 ». (Hérité de XmlWriter.)
Méthode publiqueWriteStartDocumentAsync(Boolean)Écrit de façon asynchrone la déclaration XML avec la version « 1.0 » et l'attribut autonome. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteStartElement(String)En cas de substitution dans une classe dérivée, écrit une balise de début avec le nom local spécifié. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteStartElement(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é. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteStartElement(String, String, String)ةcrit la balise de début indiquée et l'associe à l'espace de noms et au préfixe spécifiés. (Substitue XmlWriter::WriteStartElement(String, String, String).)
Méthode publiqueWriteStartElementAsyncÉ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. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteStringةcrit le texte spécifié. (Substitue XmlWriter::WriteString(String).)
Méthode publiqueWriteStringAsyncÉcrit de façon asynchrone le texte spécifié. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteSurrogateCharEntityGénère et écrit l'entité de caractère de substitution correspondant à la paire de caractères de substitution. (Substitue XmlWriter::WriteSurrogateCharEntity(Char, Char).)
Méthode publiqueWriteSurrogateCharEntityAsyncGé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.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(Boolean)Écrit une valeur Boolean. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(DateTime)Écrit une valeur DateTime. (Hérité de XmlWriter.)
Méthode publiqueWriteValue(DateTimeOffset)Écrit une valeur DateTimeOffset. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(Decimal)Écrit une valeur Decimal. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(Double)Écrit une valeur Double. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(Int32)Écrit une valeur Int32. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(Int64)Écrit une valeur Int64. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(Object)Écrit la valeur de l'objet. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(Single)Écrit un nombre à virgule flottante simple précision. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteValue(String)Écrit une valeur String. (Hérité de XmlWriter.)
Méthode publiquePris en charge par XNA FrameworkWriteWhitespaceةcrit l'espace blanc spécifié. (Substitue XmlWriter::WriteWhitespace(String).)
Méthode publiqueWriteWhitespaceAsyncÉcrit de façon asynchrone l'espace blanc spécifié. (Hérité de XmlWriter.)
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. (Hérité de XmlWriter.)
Début

Cette classe implémente la classe XmlWriter.

RemarqueRemarque

Dans la version .NET Framework 2.0, la méthode recommandée consiste à créer des instances de XmlWriter à l'aide de la méthode XmlWriter::Create et de la classe XmlWriterSettings. Cela vous permet de tirer pleinement parti de toutes les nouvelles fonctionnalités incluses dans cette version. Pour plus d'informations, consultez Création de writers XML.

XmlTextWriter gère une pile d'espaces 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 effectue une promotion de la déclaration d'espace de noms vers l'élément racine pour éviter de le 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'URI de l'espace de noms "123" est substitué 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 utiliser. Dans l'exemple suivant, deux préfixes différents sont mappés vers le même URI d'espace de noms 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();

S'il existe plusieurs déclarations d'espaces de noms mappant différents préfixes vers le même URI d'espace de noms, XmlTextWriter parcourt la pile de déclarations d'espaces de noms dans le sens inverse 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, l'appel de WriteAttributeString ne spécifie pas de préfixe, par conséquent, le writer utilise le dernier préfixe ayant fait l'objet d'un push dans la pile d'espaces de noms, puis génère le code XML suivant :

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

Si des conflits d'espaces de noms se produisent, XmlTextWriter les résout en générant des préfixes de remplacement. Par exemple, si un attribut et un élément possèdent le même préfixe mais pas les mêmes 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}, où i est un nombre commençant à 1. Le nombre est réinitialisé à 1 pour chaque élément.

Les attributs associés à un URI d'espace de noms doivent posséder un préfixe (les espaces de noms par défaut ne s'appliquent pas aux attributs). Cette description est conforme à la section 5.2 de la recommandation du W3C intitulée Namespaces in XML. Si un attribut fait référence à un URI d'espace de noms, sans spécifier de préfixe, le writer génère un préfixe pour cet 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 />. Ceci permet de garantir une compatibilité avec les anciens navigateurs.

Lorsqu'un String est utilisé comme paramètre de méthode, une référence null (Nothing en Visual Basic) et String.Empty sont équivalents. String.Empty suit les règles W3C.

Pour écrire des données fortement typées, utilisez la classe XmlConvert pour convertir les types de données en chaîne. Par exemple, le code C# suivant convertit les données de Double en 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 ce qui suit :

  • les caractères non valides dans les noms d'attributs et d'éléments.

  • les caractères Unicode qui ne correspondent pas à l'encodage spécifié. Si les caractères Unicode ne conviennent pas à l'encodage spécifié, XmlTextWriter n'utilise pas des entités de caractères pour l'échappement des caractères Unicode ;

  • les attributs dupliqués ;

  • les caractères contenus dans l'identificateur public DOCTYPE ou l'identificateur de système.

Pour plus d'informations sur l'écriture en XML, consultez Écriture de XML avec XmlWriter.

Considérations sur la sécurité

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

  • Les exceptions levées par le XmlTextWriter 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.

  • Lorsque vous passez XmlTextWriter à une autre application, le flux sous-jacent est exposé à cette application. Si vous devez passer XmlTextWriter à une application de niveau de confiance partiel, vous devez plutôt utiliser un objet XmlWriter créé par la méthode Create.

  • XmlTextWriter 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.

  • Si les paramètres par défaut sont modifiés, rien ne garantit que la sortie générée se compose de données XML bien formées.

  • N'acceptez pas la prise en charge de composants tels qu'un objet Encoding, provenant d'une source non fiable.

.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

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