XmlWriterSettings.Encoding Özellik

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Kaynak:

XmlWriterSettings.cs

Kullanılacak metin kodlama türünü alır veya ayarlar.

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

Özellik Değeri

Encoding

Kullanılacak metin kodlaması. Varsayılan değer: Encoding.UTF8.

Örnekler

Aşağıdaki örnekte özelliğin nasıl ayarlanacağı gösterilmektedir Encoding :

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)

Açıklamalar

, XmlWriter karaktere göre karakter yerine karakterlerin tümünü bir kerede bir arabelleğe kodlar. Herhangi bir kodlama hatasıyla karşılaşılırsa yöntemi çağrıldığında Flush bir özel durum oluşur.

Encoding özelliği yalnızca belirtilen veya belirtilen Stream dosya adıyla oluşturulan örnekler için XmlWriter geçerlidir. XmlWriter Örnek belirtilen TextWriterile oluşturulduysa, Encoding özelliği temel alınan TextWriteröğesinin kodlamasıyla geçersiz kılınmıştır. Örneğin, bu özellik belirli XmlWriterbir için Unicode (UTF-16) olarak ayarlandıysa ancak temel alınan yazıcı , kodlaması UTF8 olarak ayarlanmış bir StreamWriter ('den TextWritertüretilir) ise, çıkış UTF-8 kodlu olur.

XmlWriter Örnek diğer çıkış parametreleriyle oluşturulursa özelliği Encoding yoksayılır.

Aşağıdaki örnekte:

• Encoding için varsayılan değer Encoding.UTF8 değeridir.

• StreamWriter olarak ayarlanır Encoding.Unicode ve StreamWriterkodlama ayarı geçersiz kılarEncoding.

• Çıkış olacaktır 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();
    }
}

Önemli

Güvenilmeyen bir Encoding kaynaktan nesne kabul etmeyin.