XmlWriterSettings.NewLineHandling Özellik

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlWriterSettings.cs

Çıktıdaki satır sonlarının normalleştirilip normalleştirmeyeceğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

NewLineHandling

Değerlerden NewLineHandling biri. Varsayılan değer: Replace.

Açıklamalar

Bu ayar, metin içeriği veya öznitelik değerleri yazılırken geçerlidir. Değerlerin NewLineHandling her biri aşağıda açıklanmıştır:

• Ayarı, Entitize karakter varlıklarıyla normalleştirme XmlReader tarafından başka türlü korunmayan yeni satır karakterlerini değiştirmesini söylerXmlWriter. Bu, çıkışın normalleştirme XmlReadertarafından okunduğu gidiş dönüş senaryolarında kullanışlıdır. ek normalleştirme kuralları, \n değerinden sonra \tyuvarlanırken öznitelik değerleri için geçerlidir ve \r bir içinde XmlReadernormalleştirildiğinde öznitelik değerlerinde bir boşlukla değiştirilir.

• ayarı, Replace yeni satır karakterlerini özelliğine özgü karakterlerle değiştirmesini NewLineChars söylerXmlWriter. Bu ayar, karakterleri korumak için özniteliklerdeki yeni satırları karakter varlıklarıyla da değiştirir. Aynı zamanda varsayılan değerdir.

• None ayarı, girişin değişmeden bırakıldığını bildirirXmlWriter. Bu ayar, herhangi bir yeni satır işleme istemediğinizde kullanılır. Bu, çıktı herhangi bir normalleştirme yapmayan ( XmlReader örneğin, varsayılan ayarlara sahip bir XmlTextReader ) tarafından okunduğunda kullanışlıdır.

Aşağıdaki tablolar, özellik ayarına WriteString bağlı olarak giriş değeriyle birlikte sağlandığında yönteminin çıkışını NewLineHandling gösterir. Tablolar, metin içeriği yazarken ve aynı zamanda bir öznitelik değeri yazarken çıkışı gösterir.

Metin Düğümü Değeri:

NewLineHandling	\r\n	\n	\r	\t
Entitize	&#D;\n	\n	&#D;	\t
Replace	\r\n	\r\n	\r\n	\t
None	\r\n	\n	\r	\t

Öznitelik Değeri:

NewLineHandling	\r\n	\n	\r	\t
Entitize	&#D;&#A;	&#A;	&#D;
Replace	&#D;&#A;	&#A;	&#D;
None	\r\n	\n	\r	\t

Uyarı

, XmlWriter bir CDATA bölümü, açıklaması veya işleme yönergesi içinde içerik yazarken aşağıdaki davranışa sahiptir. Özelliği olarak ayarlandığında Entitizebile NewLineHandling yeni satırlar hiçbir zaman karakter varlıklarıyla değiştirilmez. Bunun nedeni, karakter varlıklarının CDATA bölümlerinde, açıklamalarında veya işleme yönergelerinde tanınmamasıdır. NewLineHandling özelliği veya Replaceolarak ayarlanırsaNone, davranış bir metin düğümü değeri yazarkenkiyle aynıdır.

Aşağıdaki tabloda, normalleştirmenin XmlReader her boşluk girişi için ne döndürdüğü açıklanmaktadır. Daha fazla bilgi için W3C XML 1.0 Önerisi'nin 2.11 ve 3.3.3 bölümlerine bakın.

Değer türü	\r\n	\n	\r	\t
Metin Düğümü	\n	\n	\n	\t
Özellik	tek boşluk	tek boşluk	tek boşluk	tek boşluk

Uyarı

Normalleştirme okuyucu, yöntemi tarafından XmlReader.Create oluşturulan herhangi bir XmlReader nesnedir. Bu nesneler her zaman satır sonu normalleştirmesi ve özniteliklerin tam normalleştirmesini gerçekleştirir. Özelliği XmlTextReader olarak ayarlandıysa Normalizationtruenesne normalleştirme okuyucusu da olabilir.