XmlWriterSettings.Encoding Proprietà

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

Valore della proprietà

Codifica del testo da utilizzare. Il valore predefinito è Encoding.UTF8.

Esempio

Nell'esempio seguente viene illustrato come impostare la Encoding proprietà :

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)

Commenti

XmlWriter Codifica un buffer di caratteri in una sola volta, anziché un carattere per carattere. Viene generata un'eccezione quando viene chiamato il Flush metodo se vengono rilevati errori di codifica.

La Encoding proprietà si applica solo alle XmlWriter istanze create con l'oggetto specificato Stream o con il nome file specificato. Se l'istanza viene creata con l'oggetto XmlWriter specificato TextWriter, la Encoding proprietà viene sottoposta a override dalla codifica dell'oggetto sottostante TextWriter. Ad esempio, se questa proprietà è impostata su Unicode (UTF-16) per un particolare XmlWriter, ma il writer sottostante è un StreamWriter oggetto (che deriva da TextWriter) con la codifica impostata su UTF8, l'output sarà codificato UTF-8.

Se l'istanza XmlWriter viene creata con altri parametri di output, la Encoding proprietà viene ignorata.

Nell'esempio seguente :

• Il valore predefinito di Encoding è Encoding.UTF8.

• StreamWriter è impostato su Encoding.Unicode e la StreamWritercodifica esegue l'override dell'impostazioneEncoding.

• L'output sarà 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();
    }
}