XmlWriterSettings.NewLineHandling Tulajdonság

Definíció

Névtér:

System.Xml

Szerelvény:

System.Xml.dll

Lekéri vagy beállít egy értéket, amely jelzi, hogy normalizálja-e a sortöréseket a kimenetben.

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

Tulajdonság értéke

NewLineHandling

Az egyik NewLineHandling érték. Az alapértelmezett érték a Replace.

Megjegyzések

Ez a beállítás szövegtartalom vagy attribútumértékek írásakor érvényes. Az egyes értékek leírása NewLineHandling az alábbiak szerint történik:

• A Entitize beállítás azt jelzi, hogy a XmlWriter karakterentitásokkal való normalizálás nem őrizné meg azokat az új sorkarakterek lecserélését XmlReader , amelyeket egyébként nem őrizne meg. Ez olyan oda-vissza forgatókönyvekben hasznos, ahol a kimenetet normalizálással XmlReaderolvassa be. További normalizálási szabályok vonatkoznak az attribútumértékekre, ha a ciklikus lecsatolás óta \tnem történik meg, \n és \r az attribútumértékekben lévő szóközre cserélődik, amikor normalizálódik egy XmlReader.

• A Replace beállítás azt jelzi, hogy az XmlWriter új sorkarakterek lecserélhetők a tulajdonságban NewLineChars meghatározott karakter(ek)re. Ez a beállítás az attribútumok új sorait is lecseréli karakterentitásokra a karakterek megőrzése érdekében. Ez az alapértelmezett érték is.

• A None beállítás azt jelzi, XmlWriter hogy hagyja változatlanul a bemenetet. Ezt a beállítást akkor használja a rendszer, ha nem szeretne újsoros feldolgozást. Ez akkor hasznos, ha a kimenetet olyan olvas be, XmlReader amely nem végez normalizálást (például alapértelmezett XmlTextReader beállításokkal).)

Az alábbi táblázatok a metódus kimenetét mutatják be, WriteString ha a bemeneti érték a tulajdonságbeállítástól függően van megadva NewLineHandling . A táblázatok szöveges tartalom írásakor és attribútumérték írásakor is megjelenítik a kimenetet.

Szövegcsomópont értéke:

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

Attribútum értéke:

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

Note

A XmlWriter CDATA-szakaszon, megjegyzésen vagy feldolgozási utasításon belüli tartalom írása során az alábbi viselkedést követi. Az új vonalakat a rendszer soha nem cseréli le a karakterentitással, még akkor sem, ha a NewLineHandling tulajdonság értéke Entitize. Ennek az az oka, hogy a CDATA-szakaszok, megjegyzések vagy feldolgozási utasítások nem ismerik fel a karakterentitásokat. Ha a NewLineHandling tulajdonság értéke vagy ReplaceértékeNone, akkor a viselkedés ugyanaz, mint egy szövegcsomópont-érték írásakor.

Az alábbi táblázat azt ismerteti, hogy a normalizálás XmlReader mit ad vissza az egyes üres térbemenetekhez. További információkért lásd a W3C XML 1.0 javaslat 2.11. és 3.3.3. szakaszát.

Érték típusa	\r\n	\n	\r	\t
Szövegcsomópont	\n	\n	\n	\t
Attribute	egy szóköz	egy szóköz	egy szóköz	egy szóköz

Note

A normalizáló olvasó a metódus által XmlReader.Create létrehozott bármely XmlReader objektum. Ezek az objektumok mindig sortörés normalizálását és az attribútumok teljes normalizálását hajtják végre. Az XmlTextReader objektum normalizáló olvasó is lehet, ha a tulajdonsága Normalization be van állítva true.