Partager via


XmlWriterSettings.Encoding Propriété

Définition

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

Important

N’acceptez pas d’objet Encoding à partir d’une source non approuvée.

S’applique à