XmlWriterSettings.NewLineHandling Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of regeleinden in de uitvoer moeten worden genormaliseerd.
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, setPublic Property NewLineHandling As NewLineHandlingWaarde van eigenschap
Een van de NewLineHandling waarden. De standaardwaarde is Replace.
Opmerkingen
Deze instelling is van toepassing bij het schrijven van tekstinhoud of kenmerkwaarden. Elk van de NewLineHandling waarden wordt hieronder beschreven:
De Entitize instelling geeft aan dat nieuwe XmlWriter regeltekens moeten worden vervangen die anders niet worden bewaard door een normalisering XmlReader met tekenentiteiten. Dit is handig in retourscenario's waarbij de uitvoer wordt gelezen door een normalisering XmlReader. Aanvullende normalisatieregels zijn van toepassing op kenmerkwaarden bij het afronden van een retour sinds
\t,\nen\rworden vervangen door een spatie in kenmerkwaarden wanneer genormaliseerd in een XmlReader.Met Replace de instelling wordt aangegeven dat nieuwe XmlWriter regeltekens moeten worden vervangen door de tekens die in de NewLineChars eigenschap zijn opgegeven. Deze instelling vervangt ook nieuwe regels in kenmerken door tekenentiteiten om de tekens te behouden. Dit is ook de standaardwaarde.
De None instelling laat de XmlWriter invoer ongewijzigd. Deze instelling wordt gebruikt wanneer u geen nieuwe regelverwerking wilt. Dit is handig wanneer de uitvoer wordt gelezen door een die XmlReader geen normalisatie uitvoert (bijvoorbeeld een XmlTextReader met standaardinstellingen).)
In de volgende tabellen wordt de uitvoer van de WriteString methode weergegeven wanneer deze wordt opgegeven bij de invoerwaarde, afhankelijk van de instelling van de NewLineHandling eigenschap. De tabellen geven de uitvoer weer bij het schrijven van tekstinhoud en ook bij het schrijven van een kenmerkwaarde.
Waarde van tekstknooppunt:
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 |
Kenmerkwaarde:
NewLineHandling |
\r\n | \n | \r | \t |
|---|---|---|---|---|
Entitize |
&#D;&#A; | &#A; | &#D; | |
Replace |
&#D;&#A; | &#A; | &#D; | |
None |
\r\n | \n | \r | \t |
Note
Het XmlWriter heeft het volgende gedrag bij het schrijven van inhoud in een CDATA-sectie, opmerking of verwerkingsinstructie. Nieuwe regels worden nooit vervangen door hun tekenentiteiten, zelfs wanneer de NewLineHandling eigenschap is ingesteld op Entitize. Dit komt doordat tekenentiteiten niet worden herkend in CDATA-secties, opmerkingen of verwerkingsinstructies. Als de NewLineHandling eigenschap is ingesteld op None of Replace, is het gedrag hetzelfde als bij het schrijven van een tekstknooppuntwaarde.
In de volgende tabel wordt beschreven wat een normalisering retourneert XmlReader voor elke invoer van witruimte. Zie secties 2.11 en 3.3.3 van de W3C XML 1.0-aanbeveling voor meer informatie.
| Waardetype | \r\n | \n | \r | \t |
|---|---|---|---|---|
| Tekstknooppunt | \n | \n | \n | \t |
| Attribute | enkele spatie | enkele spatie | enkele spatie | enkele spatie |
Note
Een normaliserende lezer is elk XmlReader object dat door de XmlReader.Create methode wordt gemaakt. Deze objecten voeren altijd regeleindenormalisatie en volledige normalisatie van kenmerken uit. Het XmlTextReader object kan ook een normaliserende lezer zijn als de Normalization eigenschap is ingesteld op true.