XmlWriterSettings.Encoding XmlWriterSettings.Encoding XmlWriterSettings.Encoding XmlWriterSettings.Encoding Property

정의

사용할 텍스트 인코딩의 형식을 가져오거나 설정합니다.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

속성 값

사용할 텍스트 인코딩입니다.The text encoding to use. 기본값은 Encoding.UTF8입니다.The default is Encoding.UTF8.

예제

다음 예제에서는 XML 조각을 메모리 스트림으로 씁니다.The following example writes an XML fragment to a memory stream.

XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;

// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();

// Do additonal processing on the stream.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false

' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()

' Do additonal processing on the stream.

설명

XmlWriter 한 번에 모든 것이 아니라 문자 버퍼의 문자를 인코딩합니다.The XmlWriter encodes a buffer of characters all at once, rather than character by character. 때 예외가 throw 되는 Flush 인코딩 오류가 발생 하는 경우 메서드가 호출 됩니다.An exception is thrown when the Flush method is called if any encoding errors are encountered.

합니다 Encoding 속성에만 적용 됩니다는 XmlWriter 지정을 사용 하 여 생성 되는 인스턴스 Stream 또는 지정된 된 파일 이름입니다.The Encoding property only applies to the XmlWriter instances that are created either with the specified Stream or with the specified file name. 경우는 XmlWriter 인스턴스를 만들 지정 된 TextWriterEncoding 기본 인코딩을 통해 속성을 재정의 TextWriter.If the XmlWriter instance is created with the specified TextWriter, the Encoding property is overridden by the encoding of the underlying TextWriter. 예를 들어가이 속성은 특정 유니코드 (utf-16)로 설정할 XmlWriter, 내부 작성기 이지만 StreamWriter (에서 파생 되는 TextWriter) 출력은 u t F-8로 인코딩된 해당 인코딩과 함께 UTF8로 설정 됩니다.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.

경우는 XmlWriter 인스턴스가 다른 출력 매개 변수를 사용 하 여 만들어집니다는 Encoding 속성은 무시 됩니다.If the XmlWriter instance is created with other output parameters, the Encoding property is ignored.

다음 예제에서는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();  
    }  
}  

중요

동의 하지는 Encoding 신뢰할 수 없는 소스에서 개체입니다.Do not accept an Encoding object from an untrusted source.

적용 대상