XmlWriterSettings.Encoding Propriedade

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

Valor de Propriedade

A codificação de texto a usar. A predefinição é Encoding.UTF8.

Exemplos

O exemplo seguinte mostra como definir a Encoding propriedade:

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)

Observações

O XmlWriter computador codifica um buffer de caracteres todos de uma vez, em vez de carácter a personagem. É lançada uma exceção quando o Flush método é chamado se forem encontrados erros de codificação.

A Encoding propriedade aplica-se apenas às XmlWriter instâncias que são criadas com o nome especificado Stream ou com o nome de ficheiro especificado. Se a XmlWriter instância for criada com o especificado TextWriter, a Encoding propriedade é sobreposta pela codificação do subjacente TextWriter. Por exemplo, se esta propriedade estiver definida para Unicode (UTF-16) para um determinado XmlWriter, mas o escritor subjacente for um StreamWriter (que deriva de TextWriter) com a sua codificação definida para UTF8, a saída será codificada em UTF-8.

Se a XmlWriter instância for criada com outros parâmetros de saída, a Encoding propriedade é ignorada.

No exemplo a seguir:

• O valor padrão de Encoding é Encoding.UTF8.

• O StreamWriter está definido como Encoding.Unicode e a StreamWritercodificação 's sobrepõe-se à Encoding definição.

• A saída será 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();
    }
}