다음을 통해 공유


XmlWriterSettings.Encoding 속성

정의

사용할 텍스트 인코딩의 형식을 가져오거나 설정합니다.

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

속성 값

Encoding

사용할 텍스트 인코딩입니다. 기본값은 Encoding.UTF8입니다.

예제

다음 예제에서는 속성을 설정하는 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)

설명

문자 XmlWriter 별 문자가 아닌 문자 버퍼를 한 번에 인코딩합니다. 인코딩 오류가 발생하면 메서드가 Flush 호출될 때 예외가 throw됩니다.

이 속성은 Encoding 지정된 파일 이름을 사용하거나 지정된 Stream 파일 이름으로 만든 인스턴스에만 적용됩니다XmlWriter. 지정된 TextWriterEncoding 인스턴스를 XmlWriter 사용하여 인스턴스를 만들면 기본 인코딩을 통해 속성이 재정의됩니다TextWriter. 예를 들어 이 속성이 특정 XmlWriter항목에 대해 유니코드(UTF-16)로 설정되어 있지만 기본 작성 StreamWriter 기가 인코딩이 UTF8로 설정된 (파생 TextWriter된) 경우 출력은 UTF-8로 인코딩됩니다.

인스턴스가 XmlWriter 다른 출력 매개 변수 Encoding 를 사용하여 만들어진 경우 속성은 무시됩니다.

다음 예제에서,

  • Encoding 의 기본값은 Encoding.UTF8입니다.

  • 설정 StreamWriter 되고 Encoding.Unicode StreamWriter인코딩이 설정을 재정의합니다 Encoding .

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

중요

신뢰할 수 Encoding 없는 원본의 개체를 허용하지 마세요.

적용 대상