XmlWriterSettings.Encoding Tulajdonság

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlWriterSettings.cs

Lekéri vagy beállítja a használni kívánt szövegkódolás típusá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

Tulajdonság értéke

Encoding

A használni kívánt szövegkódolás. Az alapértelmezett érték a Encoding.UTF8.

Példák

Az alábbi példa bemutatja, hogyan állíthatja be a tulajdonságot Encoding :

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)

Megjegyzések

A XmlWriter kód egy karakterpuffert kódol egyszerre, nem karakter szerint. A metódus meghívása kivételt Flush eredményez, ha kódolási hibák lépnek fel.

A Encoding tulajdonság csak a XmlWriter megadott vagy a megadott Stream fájlnévvel létrehozott példányokra vonatkozik. Ha a XmlWriter példány a megadott TextWriterértékkel jön létre, a Encoding tulajdonságot felülírja az alapul szolgáló TextWriterkódolása. Ha például ez a tulajdonság Unicode (UTF-16) értékre van állítva egy adott XmlWriter, de a mögöttes író egy StreamWriter (amelyből TextWriterszármazik) és kódolása UTF8, a kimenet UTF-8 kódolású lesz.

Ha a XmlWriter példány más kimeneti paraméterekkel jön létre, a Encoding tulajdonság figyelmen kívül lesz hagyva.

Az alábbi példában:

• A Encoding alapértelmezett értéke Encoding.UTF8.

• A StreamWriter beállítás értéke Encoding.Unicode és a StreamWriterkódolás felülbírálja a Encoding beállítást.

• A kimenet a következő lesz 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

Ne fogad el objektumot Encoding nem megbízható forrásból.