XmlWriterSettings.NewLineHandling プロパティ

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

出力内の改行を正規化するかどうかを示す値を取得または設定します。

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 値のいずれか 1 つ。 既定値は、Replace です。

注釈

この設定は、テキストコンテンツまたは属性値を書き込むときに適用されます。 各値を次に NewLineHandling 示します。

• この設定では Entitize 、 XmlWriter 正規化 XmlReader によって保持されない新しい行文字を文字エンティティで置き換えることを指示します。 これは、正規化 XmlReaderによって出力が読み取られたラウンドトリップ シナリオで役立ちます。 それ以降\tのラウンド トリップ時に属性値に追加の正規化規則が適用され\r、\nで正規化されると属性値のスペースにXmlReader置き換えられます。

• この設定ではReplace、XmlWriter新しい行文字\r\nを 、Microsoft Windows オペレーティング システムで使用される新しい行形式に置き換えることを指示します。 これにより、メモ帳またはMicrosoft Word アプリケーションでファイルを正しく表示できるようになります。 また、この設定では、属性内の新しい行が文字エンティティに置き換えられ、文字が保持されます。 これが既定値です。

• この設定は None 、入力を XmlWriter 変更せずに残すように指示します。 この設定は、改行処理が不要な場合に使用されます。 これは、正規化を行わない出力 (既定の設定など) によって XmlReader 出力が読み取られた場合に XmlTextReader 便利です。

次の表に、プロパティの設定に WriteString 応じて入力値を指定した場合のメソッドの出力を NewLineHandling 示します。 表には、テキスト コンテンツの書き込み時と属性値の書き込み時の出力が表示されます。

Text Node Value:

	\r\n	\n	\r	\t
Entitize	&#D;\n	\n	&#D;	\t
Replace	\r\n	\r\n	\r\n	\t
なし	\r\n	\n	\r	\t

Attribute Value:

	\r\n	\n	\r	\t
Entitize	&#D;&#A;	&#A;	&#D;		
Replace	&#D;&#A;	&#A;	&#D;		
なし	\r\n	\n	\r	\t

注意

XmlWriter CDATA セクション、コメント、または処理命令内でコンテンツを記述する場合、次の動作があります。 プロパティが に設定Entitizeされている場合でも、新しい行が文字エンティティにNewLineHandling置き換えられることはありません。 これは、文字エンティティが CDATA セクション、コメント、または処理命令で認識されないためです。 プロパティが NewLineHandling 設定 None されている場合、または Replace、動作はテキスト ノードの値を書き込む場合と同じです。

次の表では、各空白入力に対して正規化によって 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
属性の値	単一スペース	単一スペース	単一スペース	単一スペース