XmlWriterSettings.Encoding Vlastnost

Reference

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví typ kódování textu, který se má použít.

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

Hodnota vlastnosti

Encoding

Kódování textu, které se má použít. Výchozí formát je Encoding.UTF8.

Příklady

Následující příklad ukazuje, jak nastavit Encoding vlastnost:

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)

Poznámky

Kóduje XmlWriter vyrovnávací paměť znaků najednou, nikoli znak podle znaku. Pokud dojde k nějakým chybám kódování, vyvolá se výjimka, když Flush je volána metoda.

Vlastnost Encoding se vztahuje pouze na XmlWriter instance, které jsou vytvořeny buď se zadaným Stream nebo se zadaným názvem souboru. XmlWriter Pokud je instance vytvořena se zadaným TextWriter, Encoding vlastnost je přepsána kódováním podkladové TextWriter. Pokud je například tato vlastnost nastavena na Unicode (UTF-16) pro konkrétní XmlWriter, ale podkladový zapisovač je StreamWriter (odvozen z TextWriter) s jeho kódováním nastavenou na UTF8, výstup bude UTF-8 kódován.

XmlWriter Pokud je instance vytvořena s jinými výstupními parametry, Encoding vlastnost je ignorována.

V následujícím příkladu:

Výchozí hodnota Encoding je Encoding.UTF8.
Nastavení je nastaveno Encoding.Unicode StreamWriter a StreamWriterkódování 'přepíše Encoding nastavení.
Výstup bude 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();
    }
}