XmlWriterSettings.Encoding Eigenschaft

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Ruft den Typ der Textcodierung ab oder legt diesen fest.

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

Eigenschaftswert

Encoding

Die zu verwendende Textcodierung. Der Standardwert ist Encoding.UTF8.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie die Encoding Eigenschaft festlegen:

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)

Hinweise

Der XmlWriter Codiert einen Puffer von Zeichen alle gleichzeitig, anstatt Zeichen nach Zeichen. Eine Ausnahme wird ausgelöst, wenn die Methode aufgerufen wird, wenn Fehler bei der Flush Codierung auftreten.

Die Encoding Eigenschaft gilt nur für die Instanzen, die XmlWriter entweder mit dem angegebenen Stream oder mit dem angegebenen Dateinamen erstellt werden. Wenn die Instanz mit dem angegebenen TextWritererstellt wird, wird die XmlWriter Encoding Eigenschaft durch die Codierung des zugrunde TextWriterliegenden Objekts außer Kraft gesetzt. Wenn diese Eigenschaft beispielsweise auf Unicode (UTF-16) für einen bestimmten XmlWriterAutor festgelegt ist, aber der zugrunde liegende Writer ist ein StreamWriter (der von TextWriter) mit seinem Codierungssatz auf UTF8 abgeleitet wird, wird die Ausgabe UTF-8 codiert.

Wenn die Instanz mit anderen Ausgabeparametern erstellt wird, wird die XmlWriter Encoding Eigenschaft ignoriert.

Im folgenden Beispiel:

• Der Standardwert von Encoding ist Encoding.UTF8.

• Die StreamWriter Codierung wird auf Encoding.Unicode festgelegt und die Codierung überschreibt die StreamWriterEncoding Einstellung.

• Die Ausgabe lautet: 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();
    }
}

Wichtig

Akzeptieren Sie kein Encoding Objekt aus einer nicht vertrauenswürdigen Quelle.