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
含まEntitize & #D \n。&#D;\n \n\n (& A); #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
含まEntitize (& A); #D & #A;&#D;&#A; (& A) #A;&#A; (& A); #D&#D; 		
ReplaceReplace (& A); #D & #A;&#D;&#A; (& A) #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 および W3C の 3.3.3 のセクションを参照してください。 XML 1.0 勧告します。For more information, see sections 2.11 and 3.3.3 of the W3C XML 1.0 Recommendation.

注意

正規化のリーダーは anyXmlReaderによって作成されたオブジェクト、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 1 つのスペースsingle space 1 つのスペースsingle space 1 つのスペースsingle space 1 つのスペースsingle space

適用対象