XmlWriterSettings.NewLineHandling Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlWriterSettings.cs

Získá nebo nastaví hodnotu označující, zda chcete normalizovat konce řádků ve výstupu.

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

Hodnota vlastnosti

NewLineHandling

Jedna z NewLineHandling hodnot. Výchozí hodnota je Replace.

Poznámky

Toto nastavení platí při psaní textových hodnot obsahu nebo atributů. Každá z NewLineHandling těchto hodnot je popsaná níže:

• Nastavení Entitize říká XmlWriter , že má nahradit nové znaky řádku, které by jinak nebyly zachovány normalizací XmlReader s entitami znaků. To je užitečné ve scénářích odezvy, kdy se výstup čte normalizací XmlReader. Další pravidla normalizace platí pro hodnoty atributů při zaokrouhlování, protože \t, \n a \r jsou nahrazeny mezerou v hodnotách atributů při normalizaci v objektu XmlReader.

• Nastavení Replace říká XmlWriter , že má nahradit nové znaky řádku znaky specifické pro danou NewLineChars vlastnost. Toto nastavení také nahrazuje nové řádky v atributech entitami znaků, aby se zachovaly znaky. Je to také výchozí hodnota.

• Nastavení None říká XmlWriter , že se má vstup ponechat beze změny. Toto nastavení se použije, když nechcete žádné zpracování nového řádku. To je užitečné, když výstup přečte XmlReader , který neprovádí normalizaci (například XmlTextReader s výchozím nastavením).)

Následující tabulky ukazují výstup WriteString metody při zadání se vstupní hodnotou v závislosti na NewLineHandling nastavení vlastnosti. Tabulky zobrazují výstup při psaní textového obsahu a také při zápisu hodnoty atributu.

Hodnota textového uzlu:

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

Hodnota atributu:

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

Poznámka:

Při XmlWriter psaní obsahu v oddílu CDATA, komentáři nebo zpracování instrukce má následující chování. Nové řádky se nikdy nenahrazovat svými entitami znaků, i když NewLineHandling je vlastnost nastavena na Entitize. Důvodem je to, že entity znaků nejsou rozpoznány v oddílech CDATA, komentářích nebo pokynech ke zpracování. Pokud je vlastnost nastavena NewLineHandling na None nebo Replace, chování je stejné jako při zápisu hodnoty textového uzlu.

Následující tabulka popisuje, jaké normalizace XmlReader vrátí pro každý vstup prázdného místa. Další informace najdete v částech 2.11 a 3.3.3 doporučení XML W3C 1.0.

Typ hodnoty	\r\n	\n	\r	\t
Textový uzel	\n	\n	\n	\t
Vlastnost	jednoduché mezery	jednoduché mezery	jednoduché mezery	jednoduché mezery

Poznámka:

Normalizační čtečka je jakýkoli XmlReader objekt vytvořený metodou XmlReader.Create . Tyto objekty vždy provádějí normalizaci zalomení řádku a úplnou normalizaci atributů. Objekt XmlTextReader může být také normalizace čtenář, pokud je jeho Normalization vlastnost nastavena na true.