XmlWriterSettings.NewLineHandling XmlWriterSettings.NewLineHandling XmlWriterSettings.NewLineHandling XmlWriterSettings.NewLineHandling Property

정의

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

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 값 중 하나입니다.One of the NewLineHandling values. 기본값은 Replace입니다.The default is Replace.

설명

이 설정은 텍스트 콘텐츠 또는 특성 값을 작성할 때 적용 됩니다.This setting applies when writing text content or attribute values. 각는 NewLineHandling 아래 값에 설명 합니다.Each of the NewLineHandling values is described below:

  • Entitize 설정은 알립니다 합니다 XmlWriter 는 유지 하지를 정규화 하 여 새 줄 문자를 바꾸려면 XmlReader 문자 엔터티를 사용 하 여 합니다.The Entitize setting tells the XmlWriter to replace new line characters that would not be otherwise preserved by a normalizing XmlReader with character entities. 이 정규화 하 여 출력을 읽을 라운드트립 시나리오에서 유용 XmlReader합니다.This is useful in round-trip scenarios where the output is read by a normalizing XmlReader. 바꾸므로 라운드트립에서 특성 값에 대 한 추가 정규화 규칙 적용 \t, \n 하 고 \r 특성 값에서 정규화 하는 경우 공백으로 바뀝니다는 XmlReader.Additional normalization rules apply for attribute values when round tripping since \t, \n and \r are replaced with a space in attribute values when normalized in an XmlReader.

  • Replace 설정은 알립니다 합니다 XmlWriter 사용 하 여 새 줄 문자를 바꿀 \r\n, 형식인 새 줄 Microsoft Windows 운영 체제에서 사용 합니다.The Replace setting tells the XmlWriter to replace new line characters with \r\n, which is the new line format used by the Microsoft Windows operating system. 이렇게 하면 파일을 메모장 이나 Microsoft Word 응용 프로그램에 올바르게 표시할 수 있습니다.This helps to ensure that the file can be correctly displayed by the Notepad or Microsoft Word applications. 또한이 설정은 문자를 유지 하기 위해 문자 엔터티를 사용 하 여 특성의 새 줄을 바꿉니다.This setting also replaces new lines in attributes with character entities to preserve the characters. 기본값입니다.This is the default value.

  • None 설정은 알립니다는 XmlWriter 를 변경 하지 않고 입력 합니다.The None setting tells the XmlWriter to leave the input unchanged. 이 설정은 모든 줄 바꿈 처리 하지 않을 때 사용 됩니다.This setting is used when you do not want any new-line processing. 출력을 읽을 때 유용를 XmlReader 정규화를 수행 하지 않습니다 (예를 들어는 XmlTextReader 기본 설정을 사용 하 여.)This is useful when the output is read by an XmlReader that does not do any normalization (for example, an XmlTextReader with default settings.)

다음 표에의 출력을 WriteString 메서드는 입력 값에 따라 제공 되는 경우는 NewLineHandling 속성 설정 합니다.The following tables show the output of the WriteString method when supplied with the input value depending on the NewLineHandling property setting. 텍스트 콘텐츠를 쓸 때 테이블에 출력을 표시 및 특성 값을 작성 하는 경우.The tables show the output when writing text content and also when writing an attribute value.

Text Node Value:

\r\n\r\n \n\n \r\r \t\t
EntitizeEntitize & #D; \n&#D;\n \n\n &#D;&#D; \t\t
ReplaceReplace \r\n\r\n \r\n\r\n \r\n\r\n \t\t
없음None \r\n\r\n \n\n \r\r \t\t

Attribute Value:

\r\n\r\n \n\n \r\r \t\t
EntitizeEntitize &#D;&#A;&#D;&#A; &#A;&#A; &#D;&#D; 		
ReplaceReplace &#D;&#A;&#D;&#A; &#A;&#A; &#D;&#D; 		
없음None \r\n\r\n \n\n \r\r \t\t

참고

XmlWriter CDATA 섹션, 주석 또는 처리 명령 내에서 콘텐츠를 작성 하는 경우 다음 동작을 포함 합니다.The XmlWriter has the following behavior when writing content within a CDATA section, comment, or processing instruction. 새 줄의 문자 엔터티를 바꾸지 않습니다 경우에 합니다 NewLineHandling 속성이 Entitize합니다.New lines are never replaced with their character entities, even when the NewLineHandling property is set to Entitize. 즉, 문자 엔터티는 CDATA 섹션, 주석 또는 처리 명령에서 인식 되지 않습니다.This is because character entities are not recognized in CDATA sections, comments or processing instructions. 경우는 NewLineHandling 속성이 None 또는 Replace, 동작은 텍스트 노드 값을 작성 하는 경우와 동일 합니다.If the NewLineHandling property is set to None or Replace, the behavior is the same as when writing a text node value.

다음 표에서 정규화 XmlReader 공백 각 입력에 대해 반환 합니다.The following table describes what a normalizing XmlReader returns for each white space input. 자세한 내용은 2.11 및 3.3.3 W3C의 섹션을 참조 하세요 XML 1.0 권장 사항합니다.For more information, see sections 2.11 and 3.3.3 of the W3C XML 1.0 Recommendation.

참고

정규화 판독기는 모든 XmlReader 하 여 만든 개체는 XmlReader.Create 메서드.A normalizing reader is any XmlReader object created by the XmlReader.Create method. 이러한 개체는 항상 줄 바꿈 정규화 및 특성의 전체 정규화를 수행합니다.These objects always perform line break normalization and full normalization of attributes. 합니다 XmlTextReader 있으면 개체 정규화 판독기 수도 있습니다 Normalization 속성이 true합니다.The XmlTextReader object can also be a normalizing reader if it's Normalization property is set to true.

\r\n\r\n \n\n \r\r \t\t
텍스트 노드 값Text Node Value \n\n \n\n \n\n \t\t
특성 값Attribute Value 공백single space 공백single space 공백single space 공백single space

적용 대상