XmlWriterSettings XmlWriterSettings XmlWriterSettings XmlWriterSettings Class

정의

XmlWriter 메서드를 사용하여 만든 Create 개체에서 지원할 기능 집합을 지정합니다.Specifies a set of features to support on the XmlWriter object created by the Create method.

public ref class XmlWriterSettings sealed
public sealed class XmlWriterSettings
type XmlWriterSettings = class
Public NotInheritable Class XmlWriterSettings
상속
XmlWriterSettingsXmlWriterSettingsXmlWriterSettingsXmlWriterSettings

예제

다음 예제에서는 XmlWriter XML 파일에 기록 하 고 새 줄에 각 특성을 씁니다.The following example creates an XmlWriter that writes to an XML file and writes each attribute on a new line.

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 XmlWriterSettings = 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()

샘플 출력은 다음과 같습니다.The sample produces the following output:

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

설명

합니다 Create 메서드를 가져오기 위한 기본 메커니즘은 XmlWriter 인스턴스.The Create method is the preferred mechanism for obtaining XmlWriter instances. 합니다 Create 메서드를 XmlWriterSettings 클래스에서 구현 하는 기능을 지정 하는 XmlWriter 만들어지는 개체입니다.The Create method uses the XmlWriterSettings class to specify which features to implement in the XmlWriter object that is created.

참고

사용 중인 경우는 XmlWriter 개체를 Transform 메서드를 사용할지를 OutputSettings 속성을는 XmlWriterSettings 올바른 설정 사용 하 여 개체입니다.If you're using the XmlWriter object with the Transform method, you should use the OutputSettings property to obtain an XmlWriterSettings object with the correct settings. 이에 따라 만들어진 XmlWriter 개체가 올바른 출력 설정을 갖게 됩니다.This ensures that the created XmlWriter object has the correct output settings.

XmlWriterSettings 클래스 속성을 해당 컨트롤 데이터 규칙 및 출력 형식을 제공 합니다.The XmlWriterSettings class provides properties that control data conformance and output format.

데이터 규칙 검사 및 자동 수정에 대 한 이러한 속성을 사용 합니다.For data conformance checks and auto-corrections, use these properties:

속성Property 설명Specifies Value 기본값Default
CheckCharacters W3C에서 정의 된 대로 올바른 xml에서 문자는 확인할 지 여부를 문자 집합,입니다.Whether to check that characters are in the legal XML character set, as defined by W3C. true 또는 falsetrue or false true
ConformanceLevel 출력을 올바른 형식의 XML 1.0 문서 또는 조각 인지 확인 여부를 나타냅니다.Whether to check that output is a well-formed XML 1.0 document or fragment. ConformanceLevel.Document (문서 수준), Fragment (조각 수준), 또는 Auto (자동 검색)ConformanceLevel.Document (document-level), Fragment (fragment-level), or Auto (auto-detection) ConformanceLevel.Document (문서 수준 규칙)ConformanceLevel.Document (document-level conformance)
WriteEndDocumentOnClose 닫히지 않은 모든 요소에 닫는 태그를 추가할지 여부를 때는 Close 메서드가 호출 됩니다.Whether to add closing tags to all unclosed elements when the Close method is called. true 또는 falsetrue or false true

출력 형식에 지정 하려면 이러한 속성을 사용 합니다.To specify output format, use these properties:

속성Property 설명Specifies Value 기본값Default
Encoding 사용할 텍스트 인코딩입니다.Text encoding to use. System.Text.EncodingSystem.Text.Encoding value Encoding.UTF8
Indent 요소의 들여쓰기 여부를Whether to indent elements true 또는 falsetrue or false false (들여쓰기 없음)false (no indentation)
IndentChars 들여쓸 때 사용할 문자열 (때 사용한 Indent 로 설정 된 true).Character string to use when indenting (used when Indent is set to true). 문자열String 공백 두 개Two spaces
NewLineChars 줄 바꿈에 사용할 문자열입니다.Character string to use for line breaks. 문자열String \r\n (캐리지 리턴, 줄 바꿈)\r\n (carriage return, line feed)
NewLineHandling 줄 바꿈 문자를 처리 하는 방법입니다.How to handle newline characters. System.Xml.NewLineHandling 값: Entitize (표준화) Replace (교체) 또는 None (변경 되지 않은 상태로 둠)System.Xml.NewLineHandling value: Entitize (normalize), Replace (replace), or None (leave unchanged) Replace (지정 된 문자로 바꿉니다 NewLineChars)Replace (replace with characters specified by NewLineChars)
NewLineOnAttributes 특성을 개별 줄에 쓸지 여부를 (이 없는 경우 적용 Indentfalse).Whether to write attributes on individual lines (has no effect when Indent is false). true 또는 falsetrue or false false
OmitXmlDeclaration XML 선언을 쓸지 여부를 나타냅니다.Whether to write an XML declaration. true 또는 falsetrue or false false

생성자

XmlWriterSettings() XmlWriterSettings() XmlWriterSettings() XmlWriterSettings()

XmlWriterSettings 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the XmlWriterSettings class.

속성

Async Async Async Async

비동기 XmlWriter 메서드를 특정 XmlWriter 인스턴스에서 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether asynchronous XmlWriter methods can be used on a particular XmlWriter instance.

CheckCharacters CheckCharacters CheckCharacters CheckCharacters

XML 작성기가 문서의 모든 문자가 W3C XML 1.0 권장 사항의 "2.2 문자" 섹션을 따르는지 확인해야 하는지 표시하는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether the XML writer should check to ensure that all characters in the document conform to the "2.2 Characters" section of the W3C XML 1.0 Recommendation.

CloseOutput CloseOutput CloseOutput CloseOutput

XmlWriter 메서드를 호출한 경우 TextWriter가 내부 스트림 또는 Close()도 함께 닫을지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the XmlWriter should also close the underlying stream or TextWriter when the Close() method is called.

ConformanceLevel ConformanceLevel ConformanceLevel ConformanceLevel

XML 작성기가 XML 출력을 확인하는 규칙 수준을 가져오거나 설정합니다.Gets or sets the level of conformance that the XML writer checks the XML output for.

DoNotEscapeUriAttributes DoNotEscapeUriAttributes DoNotEscapeUriAttributes DoNotEscapeUriAttributes

XmlWriter에서 URI 특성을 이스케이프하는 않는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether the XmlWriter does not escape URI attributes.

Encoding Encoding Encoding Encoding

사용할 텍스트 인코딩의 형식을 가져오거나 설정합니다.Gets or sets the type of text encoding to use.

Indent Indent Indent Indent

요소의 들여쓰기 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether to indent elements.

IndentChars IndentChars IndentChars IndentChars

들여쓰기에 사용할 문자열을 가져오거나 설정합니다.Gets or sets the character string to use when indenting. 이 설정은 Indent 속성이 true로 설정된 경우에 사용됩니다.This setting is used when the Indent property is set to true.

NamespaceHandling NamespaceHandling NamespaceHandling NamespaceHandling

XML 콘텐츠를 쓸 때 XmlWriter에서 중복된 네임스페이스 선언을 제거할지 여부를 표시하는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether the XmlWriter should remove duplicate namespace declarations when writing XML content. 기본 동작은 작성기에서 작성기의 네임스페이스 확인자에 있는 모든 네임스페이스 선언을 출력하는 것입니다.The default behavior is for the writer to output all namespace declarations that are present in the writer's namespace resolver.

NewLineChars NewLineChars NewLineChars NewLineChars

줄 바꿈에 사용할 문자열을 가져오거나 설정합니다.Gets or sets the character string to use for line breaks.

NewLineHandling NewLineHandling NewLineHandling NewLineHandling

줄 바꿈을 출력에 정규화할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether to normalize line breaks in the output.

NewLineOnAttributes NewLineOnAttributes NewLineOnAttributes NewLineOnAttributes

특성을 새 줄에 쓸지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether to write attributes on a new line.

OmitXmlDeclaration OmitXmlDeclaration OmitXmlDeclaration OmitXmlDeclaration

XML 선언을 생략할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether to omit an XML declaration.

OutputMethod OutputMethod OutputMethod OutputMethod

XmlWriter 출력을 serialize하는 데 사용되는 메서드를 가져옵니다.Gets the method used to serialize the XmlWriter output.

WriteEndDocumentOnClose WriteEndDocumentOnClose WriteEndDocumentOnClose WriteEndDocumentOnClose

XmlWriter 메서드가 호출될 때 Close()가 닫히지 않은 모든 요소 태그에 닫는 태그를 추가할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether the XmlWriter will add closing tags to all unclosed element tags when the Close() method is called.

메서드

Clone() Clone() Clone() Clone()

XmlWriterSettings 인스턴스의 복사본을 만듭니다.Creates a copy of the XmlWriterSettings instance.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
Reset() Reset() Reset() Reset()

설정 클래스의 멤버를 해당 기본값으로 다시 설정합니다.Resets the members of the settings class to their default values.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

적용 대상