XmlWriterSettings.Encoding Egenskap

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

Egenskapsvärde

Den textkodning som ska användas. Standardvärdet är Encoding.UTF8.

Exempel

I följande exempel visas hur du Encoding anger egenskapen:

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)

Kommentarer

Kodar XmlWriter en buffert med tecken samtidigt i stället för tecken efter tecken. Ett undantag utlöses när Flush metoden anropas om några kodningsfel påträffas.

Egenskapen Encoding gäller endast för de XmlWriter instanser som skapas antingen med det angivna Stream eller med det angivna filnamnet. Om instansen XmlWriter skapas med angiven TextWriterEncoding , åsidosättas egenskapen av kodningen av den underliggande TextWriter. Om den här egenskapen till exempel är inställd på Unicode (UTF-16) för en viss XmlWriter, men den underliggande skrivaren är en StreamWriter (som härleds från TextWriter) med kodningen inställd på UTF8, kodas utdata UTF-8.

Om instansen XmlWriter skapas med andra utdataparametrar ignoreras egenskapen Encoding .

I följande exempel:

• Standardvärdet för Encoding är Encoding.UTF8.

• StreamWriter Är inställt på Encoding.Unicode och StreamWriterkodningen åsidosätter Encoding inställningen.

• Utdata blir 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();
    }
}