XmlWriterSettings.Encoding Properti

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlWriterSettings.cs

Mendapatkan atau mengatur jenis pengodean teks yang akan digunakan.

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

Nilai Properti

Encoding

Pengodean teks yang akan digunakan. Defaultnya adalah Encoding.UTF8.

Contoh

Contoh berikut menunjukkan cara mengatur Encoding properti:

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)

Keterangan

Mengodekan XmlWriter buffer karakter sekaligus, bukan karakter berdasarkan karakter. Pengecualian dilemparkan ketika metode dipanggil Flush jika ada kesalahan pengodean yang ditemui.

Properti Encoding hanya berlaku untuk XmlWriter instans yang dibuat baik dengan yang ditentukan Stream atau dengan nama file yang ditentukan. XmlWriter Jika instans dibuat dengan yang ditentukan TextWriter, Encoding properti akan ditimpa oleh pengodean yang mendasar TextWriter. Misalnya, jika properti ini diatur ke Unicode (UTF-16) untuk tertentu XmlWriter, tetapi penulis yang mendasar adalah StreamWriter (yang berasal dari TextWriter) dengan pengodeannya diatur ke UTF8, output akan dikodekan UTF-8.

XmlWriter Jika instans dibuat dengan parameter output lainnya, Encoding properti diabaikan.

Dalam contoh berikut:

• Nilai default Encoding adalah Encoding.UTF8.

• StreamWriter diatur ke Encoding.Unicode dan StreamWriterpengodean 's mengambil alih Encoding pengaturan.

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

Penting

Jangan terima Encoding objek dari sumber yang tidak tepercaya.