XmlWriterSettings.Encoding Vlastnost

Definice

Získá nebo nastaví typ kódování textu, které se má použít.Gets or sets the type of text encoding to use.

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

Hodnota vlastnosti

Encoding

Kódování textu, které se má použít.The text encoding to use. Výchozí formát je Encoding.UTF8.The default is Encoding.UTF8.

Příklady

Následující příklad ukazuje, jak nastavit Enconding vlastnost:The following example shows how to set the Enconding property:

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)

Poznámky

XmlWriterZakóduje vyrovnávací paměť všech znaků najednou, nikoli znak po znaku.The XmlWriter encodes a buffer of characters all at once, rather than character by character. Výjimka je vyvolána, když Flush je metoda volána, pokud dojde k chybám kódování.An exception is thrown when the Flush method is called if any encoding errors are encountered.

EncodingVlastnost se vztahuje pouze na XmlWriter instance vytvořené buď se zadaným názvem, Stream nebo se zadaným názvem souboru.The Encoding property only applies to the XmlWriter instances that are created either with the specified Stream or with the specified file name. Pokud XmlWriter je instance vytvořena se zadaným parametrem TextWriter , Encoding je vlastnost přepsána kódováním podkladu TextWriter .If the XmlWriter instance is created with the specified TextWriter, the Encoding property is overridden by the encoding of the underlying TextWriter. Například pokud je tato vlastnost nastavená na Unicode (UTF-16) pro konkrétní XmlWriter , ale podkladový zapisovač je StreamWriter (který je odvozený z TextWriter ) s jeho kódováním nastaveným na UTF8, výstup bude kódovaný v kódování UTF-8.For example, if this property is set to Unicode (UTF-16) for a particular XmlWriter, but the underlying writer is a StreamWriter (which derives from TextWriter) with its encoding set to UTF8, the output will be UTF-8 encoded.

Pokud XmlWriter je instance vytvořena s jinými výstupními parametry, Encoding vlastnost je ignorována.If the XmlWriter instance is created with other output parameters, the Encoding property is ignored.

V následujícím příkladu:In the following example:

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

Důležité

Nepřijímejte Encoding objekt z nedůvěryhodného zdroje.Do not accept an Encoding object from an untrusted source.

Platí pro