XmlWriterSettings.Encoding Eigenschaft

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

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

Beispiele

Das folgende Beispiel zeigt, wie die Encoding Eigenschaft festgelegt wird:

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 auf einmal statt zeichenübergreifend. Eine Ausnahme wird ausgelöst, wenn die Flush Methode aufgerufen wird, wenn Codierungsfehler aufgetreten sind.

Die Encoding Eigenschaft gilt nur für die XmlWriter Instanzen, die entweder mit dem angegebenen Stream oder mit dem angegebenen Dateinamen erstellt werden. Wenn die XmlWriter Instanz mit dem angegebenen TextWriterErstellt wird, wird die Encoding Eigenschaft durch die Codierung der zugrunde liegenden TextWriterüberschrieben. Wenn diese Eigenschaft z. B. für eine bestimmte XmlWriterEigenschaft auf Unicode (UTF-16) festgelegt ist, der zugrunde liegende Writer jedoch ein StreamWriter (abgeleitet von TextWriter) ist, dessen Codierung auf UTF8 festgelegt ist, wird die Ausgabe UTF-8-codiert.

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

Im folgenden Beispiel:

• Der Standardwert von Encoding ist Encoding.UTF8.

• Die StreamWriter Einstellung wird festgelegt Encoding.Unicode , und die StreamWriterCodierung setzt die Encoding Einstellung außer Kraft.

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