XmlWriterSettings.Encoding Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlWriterSettings.cs

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í hodnota 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

XmlWriter Zakóduje vyrovnávací paměť znaků najednou, nikoli znak podle znaků. Pokud dojde k nějakým chybám kódování, vyvolá se výjimka při Flush zavolání metody.

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 se přepíše kódováním podkladového TextWriterobjektu . Pokud je například tato vlastnost nastavena na Unicode (UTF-16) pro konkrétní XmlWriter, ale podkladový zapisovač je StreamWriter (který je odvozen z TextWriter) s jeho kódováním nastavenou na UTF8, výstup bude kódování UTF-8.

XmlWriter Pokud je instance vytvořena s jinými výstupními parametry, Encoding vlastnost se ignoruje.

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

• Výchozí hodnota atributu Encoding je Encoding.UTF8.

• Nastavení StreamWriter je nastavené Encoding.Unicode 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();
    }
}

Důležité

Nepřijímají objekt Encoding z nedůvěryhodného zdroje.