XmlWriterSettings 클래스

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

어셈블리:

System.Xml.dll

어셈블리:

netstandard.dll

XmlWriter 메서드를 사용하여 만든 Create 개체에서 지원할 기능 집합을 지정합니다.

public ref class XmlWriterSettings sealed

public sealed class XmlWriterSettings

type XmlWriterSettings = class

Public NotInheritable Class XmlWriterSettings

상속

Object

XmlWriterSettings

예제

다음 예제에서는 XML 파일에 쓰고 각 특성을 새 줄에 쓰는 방법을 만듭니다 XmlWriter .

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
settings.NewLineOnAttributes = true;

writer = XmlWriter.Create(Console.Out, settings);

writer.WriteStartElement("order");
writer.WriteAttributeString("orderID", "367A54");
writer.WriteAttributeString("date", "2001-05-03");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
    
writer.Flush();

        Dim settings As New XmlWriterSettings()
        settings.Indent = True
        settings.OmitXmlDeclaration = True
        settings.NewLineOnAttributes = True
   
        writer = XmlWriter.Create(Console.Out, settings)

        writer.WriteStartElement("order")
        writer.WriteAttributeString("orderID", "367A54")
        writer.WriteAttributeString("date", "2001-05-03")
        writer.WriteElementString("price", "19.95")
        writer.WriteEndElement()

        writer.Flush()

샘플은 다음 출력을 생성합니다.

<order
  orderID="367A54"
  date="2001-05-03">
  <price>19.95</price>
</order>

설명

이 Create 메서드는 인스턴스를 가져오기 XmlWriter 위한 기본 메커니즘입니다. 이 메서드는 Create 클래스를 XmlWriterSettings 사용하여 생성된 개체에서 XmlWriter 구현할 기능을 지정합니다.

참고

메서드와 함께 개체를 XmlWriter 사용하는 경우 속성을 사용하여 OutputSettings 올바른 설정으로 개체를 XmlWriterSettings 가져와야 Transform 합니다. 이에 따라 만들어진 XmlWriter 개체가 올바른 출력 설정을 갖게 됩니다.

이 클래스는 XmlWriterSettings 데이터 규칙 및 출력 형식을 제어하는 속성을 제공합니다.

데이터 규칙 검사 및 자동 수정의 경우 다음 속성을 사용합니다.

속성	설명	값	기본값
CheckCharacters	W3C에서 정의한 대로 문자가 유효한 XML 문자 집합에 있는지 여부를 확인합니다.	true 또는 false	true
ConformanceLevel	출력이 올바른 형식의 XML 1.0 문서인지 또는 조각인지 확인합니다.	ConformanceLevel.Document (문서 수준), Fragment (조각 수준) 또는 Auto (자동 검색)	ConformanceLevel.Document (문서 수준 규칙)
WriteEndDocumentOnClose	메서드를 호출할 때 닫지 않은 모든 요소에 닫는 태그를 Close 추가할지 여부를 지정합니다.	true 또는 false	true

출력 형식을 지정하려면 다음 속성을 사용합니다.

속성	설명	값	기본값
Encoding	사용할 텍스트 인코딩입니다.	System.Text.Encoding 값	Encoding.UTF8
Indent	요소를 들여쓰는지 여부	true 또는 false	false (들여쓰기 없음)
IndentChars	들여쓰기할 때 사용할 문자 문자열입니다(설정된 true경우 Indent 사용됨).	String	두 개의 공백
NewLineChars	줄 바꿈에 사용할 문자열입니다.	String	\r\n (캐리지 리턴, 줄 바꿈)
NewLineHandling	줄무늬 문자를 처리하는 방법입니다.	System.Xml.NewLineHandling value: Entitize (normalize), Replace (replace) 또는 None (그대로 유지)	Replace (다음으로 지정된 문자로 바꾸기 NewLineChars)
NewLineOnAttributes	개별 줄에 특성을 쓸지 여부입니다(있는 경우 Indent false아무런 영향이 없음).	true 또는 false	false
OmitXmlDeclaration	XML 선언을 작성할지 여부입니다.	true 또는 false	false

생성자

XmlWriterSettings()

XmlWriterSettings 클래스의 새 인스턴스를 초기화합니다.

속성

Async	비동기 XmlWriter 메서드를 특정 XmlWriter 인스턴스에서 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
CheckCharacters	XML 작성기가 문서의 모든 문자가 W3C XML 1.0 권장 사항의 "2.2 문자" 섹션을 따르는지 확인해야 하는지 표시하는 값을 가져오거나 설정합니다.
CloseOutput	XmlWriter 메서드를 호출한 경우 TextWriter가 내부 스트림 또는 Close()도 함께 닫을지 여부를 나타내는 값을 가져오거나 설정합니다.
ConformanceLevel	XML 작성기가 XML 출력을 확인하는 규칙 수준을 가져오거나 설정합니다.
DoNotEscapeUriAttributes	XmlWriter에서 URI 특성을 이스케이프하는 않는지를 나타내는 값을 가져오거나 설정합니다.
Encoding	사용할 텍스트 인코딩의 형식을 가져오거나 설정합니다.
Indent	요소의 들여쓰기 여부를 나타내는 값을 가져오거나 설정합니다.
IndentChars	들여쓰기에 사용할 문자열을 가져오거나 설정합니다. 이 설정은 Indent 속성이 true로 설정된 경우에 사용됩니다.
NamespaceHandling	XML 콘텐츠를 쓸 때 XmlWriter에서 중복된 네임스페이스 선언을 제거할지 여부를 표시하는 값을 가져오거나 설정합니다. 기본 동작은 작성기에서 작성기의 네임스페이스 확인자에 있는 모든 네임스페이스 선언을 출력하는 것입니다.
NewLineChars	줄 바꿈에 사용할 문자열을 가져오거나 설정합니다.
NewLineHandling	줄 바꿈을 출력에 정규화할지 여부를 나타내는 값을 가져오거나 설정합니다.
NewLineOnAttributes	특성을 새 줄에 쓸지 여부를 나타내는 값을 가져오거나 설정합니다.
OmitXmlDeclaration	XML 선언을 생략할지 여부를 나타내는 값을 가져오거나 설정합니다.
OutputMethod	XmlWriter 출력을 serialize하는 데 사용되는 메서드를 가져옵니다.
WriteEndDocumentOnClose	XmlWriter 메서드가 호출될 때 Close()가 닫히지 않은 모든 요소 태그에 닫는 태그를 추가할지 여부를 나타내는 값을 가져오거나 설정합니다.

메서드

Clone()	XmlWriterSettings 인스턴스의 복사본을 만듭니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
Reset()	설정 클래스의 멤버를 해당 기본값으로 다시 설정합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)