XmlWriterSettings.Encoding Propriété

Référence

Définition

Espace de noms:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le type d'encodage de texte à utiliser.

public:
 property System::Text::Encoding ^ Encoding { System::Text::Encoding ^ get(); void set(System::Text::Encoding ^ value); };

public System.Text.Encoding Encoding { get; set; }

member this.Encoding : System.Text.Encoding with get, set

Public Property Encoding As Encoding

Valeur de propriété

Encoding

Encodage de texte à utiliser. La valeur par défaut est Encoding.UTF8.

Exemples

L’exemple suivant montre comment définir la Encoding propriété :

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

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.Encoding = Encoding.Unicode
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Remarques

L’encode XmlWriter une mémoire tampon de caractères toutes à la fois, plutôt que de caractère par caractère. Une exception est levée lorsque la Flush méthode est appelée si des erreurs d’encodage sont rencontrées.

La Encoding propriété s’applique uniquement aux XmlWriter instances créées avec le nom de fichier spécifié Stream ou avec le nom de fichier spécifié. Si l’instance XmlWriter est créée avec le spécifié TextWriter, la Encoding propriété est remplacée par l’encodage du sous-jacent TextWriter. Par exemple, si cette propriété est définie sur Unicode (UTF-16) pour un particulier XmlWriter, mais que l’enregistreur sous-jacent est un StreamWriter (qui dérive de TextWriter) avec son encodage défini sur UTF8, la sortie est encodée en UTF-8.

Si l’instance XmlWriter est créée avec d’autres paramètres de sortie, la Encoding propriété est ignorée.

Dans l’exemple suivant :

La valeur par défaut de Encoding est Encoding.UTF8.
L’encodage StreamWriter est défini Encoding.Unicode sur et l’encodage StreamWriterdu fichier remplace le Encoding paramètre.
La sortie est la suivante Encoding.Unicode.

using (StreamWriter output =
    new StreamWriter(new FileStream("Xml01.xml", FileMode.Create), Encoding.Unicode))
{
    using (XmlWriter xmlWriter =
        XmlWriter.Create(output, new XmlWriterSettings()))
    {
        xmlWriter.WriteStartDocument();
        xmlWriter.WriteStartElement("Root");
        xmlWriter.WriteEndElement();
        xmlWriter.WriteEndDocument();
    }
}