Sdílet prostřednictvím


XmlWriterSettings.NewLineHandling Vlastnost

Definice

Získá nebo nastaví hodnotu označující, zda 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

Jedna z NewLineHandling hodnot. Výchozí formát je Replace.

Poznámky

Toto nastavení platí při psaní hodnot textového obsahu nebo atributů. Jednotlivé hodnoty jsou popsány NewLineHandling níže:

  • Nastavení Entitize říká, XmlWriter že má nahradit znaky nového řádku, které by jinak nebyly zachovány normalizací XmlReader se znakovými entitami. To je užitečné ve scénářích odezvy, kdy je výstup přečtený normalizací XmlReader. Další normalizační pravidla se použijí pro hodnoty atributů při zakopnutí od \t\n a \r při normalizaci v atributu se nahradí mezerou XmlReaderv hodnotách atributů.

  • Nastavení Replace říká, XmlWriter že má nahradit znaky nového řádku znaky určenými ve NewLineChars vlastnosti . Toto nastavení také nahradí nové řádky v atributech entitami znaků, aby se zachovaly znaky. Je to také výchozí hodnota.

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

Následující tabulky zobrazují 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.

Text Node Value:

\r\n \n \r \t
Entitizace &#D;\n \n &#D; \t
Nahrazení \r\n \r\n \r\n \t
Žádné \r\n \n \r \t

Attribute Value:

\r\n \n \r \t
Entitizace &#D;&#A; &#A; &#D;
Nahrazení &#D;&#A; &#A; &#D;
Žádné \r\n \n \r \t

Poznámka

XmlWriter následující chování při psaní obsahu v rámci oddílu CDATA, komentáře nebo zpracování instrukce. Nové řádky se nikdy nenahradí entitami svých znaků, a to ani v případě, že NewLineHandling je vlastnost nastavená na Entitize. Důvodem je to, že se v oddílech, komentářích nebo pokynech pro zpracování CDATA nerozpoznají entity znaků. NewLineHandling Pokud je vlastnost nastavena na None nebo Replace, chování je stejné jako při zápisu hodnoty textového uzlu.

Následující tabulka popisuje, co normalizace XmlReader vrátí pro každý vstup prázdných znaků. Další informace najdete v oddílech 2.11 a 3.3.3 doporučení W3C XML 1.0.

Poznámka

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

\r\n \n \r \t
Hodnota textového uzlu \n \n \n \t
Hodnota atributu jednoduché mezery jednoduché mezery jednoduché mezery jednoduché mezery

Platí pro