XmlWriterSettings.NewLineHandling 속성

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

Source:

XmlWriterSettings.cs

줄 바꿈을 출력에 정규화할지 여부를 나타내는 값을 가져오거나 설정합니다.

public:
 property System::Xml::NewLineHandling NewLineHandling { System::Xml::NewLineHandling get(); void set(System::Xml::NewLineHandling value); };

public System.Xml.NewLineHandling NewLineHandling { get; set; }

member this.NewLineHandling : System.Xml.NewLineHandling with get, set

Public Property NewLineHandling As NewLineHandling

속성 값

NewLineHandling

NewLineHandling 값 중 하나입니다. 기본값은 Replace입니다.

설명

이 설정은 텍스트 콘텐츠 또는 특성 값을 작성할 때 적용됩니다. NewLineHandling 각 값은 아래에 설명되어 있습니다.

• 설정은 Entitize 문자 엔터티로 정규화 XmlReader 하여 유지되지 않는 새 줄 문자를 바꾸도록 에 지시 XmlWriter 합니다. 이는 정규화를 XmlReader통해 출력을 읽는 왕복 시나리오에서 유용합니다. 이후 왕복 \t\n 할 때 특성 값에 대해 추가 정규화 규칙이 적용되며 \r 에서 정규화될 XmlReader때 특성 값의 공백으로 대체됩니다.

• 설정은 Replace 에 새 줄 문자를 속성에 지정된 NewLineChars 문자로 바꾸도록 지시 XmlWriter 합니다. 또한 이 설정은 특성의 새 줄을 문자 엔터티로 대체하여 문자를 유지합니다. 기본값이기도 합니다.

• 설정은 None 입력을 XmlWriter 변경하지 않은 상태로 두도록 에 지시합니다. 이 설정은 새 줄 처리를 원하지 않는 경우에 사용됩니다. 이는 정규화를 수행하지 않는 에서 출력을 XmlReader 읽을 때 유용합니다(예: 기본 설정이 있는 XmlTextReader ).

다음 표에서는 속성 설정에 WriteString 따라 입력 값과 함께 제공된 경우 메서드의 출력을 NewLineHandling 보여 줍니다. 표에는 텍스트 콘텐츠를 작성할 때와 특성 값을 작성할 때도 출력이 표시됩니다.

Text Node Value:

	\r\n	\n	\r	\t
엔터티화	&#D;\n	\n	&#D;	\t
바꾸기	\r\n	\r\n	\r\n	\t
None	\r\n	\n	\r	\t

Attribute Value:

	\r\n	\n	\r	\t
엔터티화	&#D;&#A;	&#A;	&#D;
바꾸기	&#D;&#A;	&#A;	&#D;
None	\r\n	\n	\r	\t

참고

는 XmlWriter CDATA 섹션, 주석 또는 처리 명령 내에서 콘텐츠를 작성할 때 다음과 같은 동작을 수행합니다. 속성이 로 설정된 경우에도 NewLineHandling 새 줄은 해당 문자 엔터티로 Entitize대체되지 않습니다. 이는 문자 엔터티가 CDATA 섹션, 주석 또는 처리 지침에서 인식되지 않기 때문입니다. 속성이 NewLineHandling 또는 Replace로 None 설정된 경우 동작은 텍스트 노드 값을 작성할 때와 동일합니다.

다음 표에서는 각 공백 입력에 대해 정규화가 반환하는 XmlReader 내용을 설명합니다. 자세한 내용은 W3C XML 1.0 권장 사항의 섹션 2.11 및 3.3.3을 참조하세요.

참고

정규화 판독기는 메서드에서 만든 모든 XmlReader 개체입니다 XmlReader.Create . 이러한 개체는 항상 줄 바꿈 정규화 및 특성의 전체 정규화를 수행합니다. 속성이 XmlTextReader 로 설정된 true경우 Normalization 개체가 정규화 판독기일 수도 있습니다.

	\r\n	\n	\r	\t
텍스트 노드 값	\n	\n	\n	\t
특성 값	단일 공간	단일 공간	단일 공간	단일 공간