Aracılığıyla paylaş


XmlWriterSettings.NewLineHandling Özellik

Tanım

Çıktıdaki satır sonlarının normalleştirilip normalleştirılmeyeceğ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

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 normalleştirme XmlReader tarafından karakter varlıklarıyla korunmayan yeni satır karakterlerini değiştirmesini söylerXmlWriter. Bu, çıkışın normalleştirme XmlReadertarafından okunduğu gidiş dönüş senaryolarında yararlıdır. 'den sonra \t\n yuvarlama yaparken öznitelik değerleri için ek normalleştirme kuralları uygulanır 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şini değiştirmeden bırakmasını söylerXmlWriter. Bu ayar, herhangi bir yeni satır işlemesi 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 yararlı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 öznitelik değeri yazarken çıkışı gösterir.

Text Node Value:

\r\n \n \r \t
Entitize &#D;\n \n &#D; \t
Değiştir \r\n \r\n \r\n \t
Hiçbiri \r\n \n \r \t

Attribute Value:

\r\n \n \r \t
Entitize &#D;&#A; &#A; &#D;
Değiştir &#D;&#A; &#A; &#D;
Hiçbiri \r\n \n \r \t

Not

bir XmlWriter CDATA bölümü, açıklaması veya işleme yönergesi içinde içerik yazarken aşağıdaki davranışa sahiptir. Özellik 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 ayarlandıysaNone, davranış bir metin düğümü değeri yazarken olduğu gibi olur.

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.

Not

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. XmlTextReader Özelliği olarak ayarlandıysa Normalizationtruenesne normalleştirme okuyucusu da olabilir.

\r\n \n \r \t
Metin Düğümü Değeri \n \n \n \t
Öznitelik Değeri tek boşluk tek boşluk tek boşluk tek boşluk

Şunlara uygulanır