XmlWriterSettings.NewLineHandling Properti

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlWriterSettings.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menormalkan hentian baris dalam 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

Nilai Properti

NewLineHandling

Salah NewLineHandling satu nilai. Default adalah Replace.

Keterangan

Pengaturan ini berlaku saat menulis konten teks atau nilai atribut. NewLineHandling Masing-masing nilai dijelaskan di bawah ini:

• Entitize Pengaturan memberi tahu XmlWriter untuk mengganti karakter baris baru yang tidak akan dipertahankan dengan normalisasi XmlReader dengan entitas karakter. Ini berguna dalam skenario round-trip di mana output dibaca dengan normalisasi XmlReader. Aturan normalisasi tambahan berlaku untuk nilai atribut saat round tripping sejak \t, \n dan \r diganti dengan spasi dalam nilai atribut saat dinormalisasi dalam XmlReader.

• Replace Pengaturan memberi tahu XmlWriter untuk mengganti karakter baris baru dengan karakter yang ditentukan dalam NewLineChars properti . Pengaturan ini juga menggantikan baris baru dalam atribut dengan entitas karakter untuk mempertahankan karakter. Ini juga merupakan nilai default.

• Pengaturan None memberi tahu XmlWriter untuk membiarkan input tidak berubah. Pengaturan ini digunakan ketika Anda tidak ingin pemrosesan baris baru. Ini berguna ketika output dibaca oleh XmlReader yang tidak melakukan normalisasi apa pun (misalnya, XmlTextReader dengan pengaturan default.)

Tabel berikut menunjukkan output WriteString metode saat disediakan dengan nilai input tergantung pada NewLineHandling pengaturan properti. Tabel menunjukkan output saat menulis konten teks dan juga saat menulis nilai atribut.

Text Node Value:

	\r\n	\n	\r	\t
Hak	&#D;\n	\n	&#D;	\t
Ganti	\r\n	\r\n	\r\n	\t
Tidak ada	\r\n	\n	\r	\t

Attribute Value:

	\r\n	\n	\r	\t
Hak	&#D;&#A;	&#A;	&#D;
Ganti	&#D;&#A;	&#A;	&#D;
Tidak ada	\r\n	\n	\r	\t

Catatan

XmlWriter memiliki perilaku berikut saat menulis konten dalam bagian CDATA, komentar, atau instruksi pemrosesan. Baris baru tidak pernah diganti dengan entitas karakternya, bahkan ketika NewLineHandling properti diatur ke Entitize. Ini karena entitas karakter tidak dikenali di bagian CDATA, komentar, atau instruksi pemrosesan. NewLineHandling Jika properti diatur ke None atau Replace, perilakunya sama seperti saat menulis nilai simpul teks.

Tabel berikut menjelaskan apa yang dikembalikan normalisasi XmlReader untuk setiap input spasi kosong. Untuk informasi selengkapnya, lihat bagian 2.11 dan 3.3.3 dari Rekomendasi W3C XML 1.0.

Catatan

Pembaca normalisasi adalah objek apa pun XmlReader yang XmlReader.Create dibuat oleh metode . Objek-objek ini selalu melakukan normalisasi pemutusan baris dan normalisasi atribut penuh. Objek XmlTextReader juga dapat menjadi pembaca normalisasi jika Normalization properti diatur ke true.

	\r\n	\n	\r	\t
Nilai Simpul Teks	\n	\n	\n	\t
Menilai Atribut	spasi tunggal	spasi tunggal	spasi tunggal	spasi tunggal