XmlWriterSettings.Encoding Eigenschap

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

Waarde van eigenschap

De te gebruiken tekstcodering. De standaardwaarde is Encoding.UTF8.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de Encoding eigenschap instelt:

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)

Opmerkingen

De XmlWriter codeert een buffer van tekens in één keer, in plaats van tekens per teken. Er wordt een uitzondering gegenereerd wanneer de Flush methode wordt aangeroepen als er coderingsfouten optreden.

De Encoding eigenschap is alleen van toepassing op de XmlWriter exemplaren die zijn gemaakt met de opgegeven Stream of met de opgegeven bestandsnaam. Als het XmlWriter exemplaar wordt gemaakt met de opgegeven TextWriter, wordt de Encoding eigenschap overschreven door de codering van de onderliggende TextWriterwaarde. Als deze eigenschap bijvoorbeeld is ingesteld op Unicode (UTF-16) voor een bepaalde XmlWriter, maar de onderliggende schrijver een StreamWriter (afgeleid van TextWriter) is met de codering ingesteld op UTF8, wordt de uitvoer UTF-8 gecodeerd.

Als het XmlWriter exemplaar wordt gemaakt met andere uitvoerparameters, wordt de Encoding eigenschap genegeerd.

In het volgende voorbeeld:

• De standaardwaarde van Encoding is Encoding.UTF8.

• De StreamWriter instelling wordt ingesteld Encoding.Unicode op en de StreamWritercodering overschrijft de Encoding instelling.

• De uitvoer is 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();
    }
}