XmlWriterSettings.NewLineHandling XmlWriterSettings.NewLineHandling XmlWriterSettings.NewLineHandling XmlWriterSettings.NewLineHandling Property

Definition

Ruft einen Wert ab, der angibt, ob Zeilenumbrüche in der Ausgabe normalisiert werden sollen, oder legt diesen fest.Gets or sets a value indicating whether to normalize line breaks in the output.

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

Eigenschaftswert

Einer der NewLineHandling-Werte.One of the NewLineHandling values. Die Standardeinstellung ist Replace.The default is Replace.

Hinweise

Diese Einstellung gilt beim Schreiben von Text Inhalt oder Attributwerten.This setting applies when writing text content or attribute values. NewLineHandling Alle Werte werden im folgenden beschrieben:Each of the NewLineHandling values is described below:

  • Die Entitize -Einstellung weist XmlWriter das an, neue Zeilenzeichen zu ersetzen, die andernfalls durch eine Normalisierung XmlReader mit Zeichen Entitäten nicht beibehalten werden.The Entitize setting tells the XmlWriter to replace new line characters that would not be otherwise preserved by a normalizing XmlReader with character entities. Dies ist in Roundtrip-Szenarien hilfreich, in denen die Ausgabe durch eine Normalisierung XmlReadergelesen wird.This is useful in round-trip scenarios where the output is read by a normalizing XmlReader. Weitere normalisierungs Regeln gelten für Attributwerte, wenn das Roundtrip \n seit \r \tist, und werden durch ein Leerzeichen in Attributwerten ersetzt, XmlReaderWenn Sie in einer normalisiert werden.Additional normalization rules apply for attribute values when round tripping since \t, \n and \r are replaced with a space in attribute values when normalized in an XmlReader.

  • Die Replace -Einstellung weist XmlWriter den an \r\n, neue Zeilenzeichen durch zu ersetzen, d. h. das neue Zeilen Format, das vom Microsoft Windows-Betriebssystem verwendet wird.The Replace setting tells the XmlWriter to replace new line characters with \r\n, which is the new line format used by the Microsoft Windows operating system. Dadurch wird sichergestellt, dass die Datei von den Notepad-oder Microsoft Word-Anwendungen ordnungsgemäß angezeigt werden kann.This helps to ensure that the file can be correctly displayed by the Notepad or Microsoft Word applications. Diese Einstellung ersetzt auch neue Zeilen in Attributen mit Zeichen Entitäten, um die Zeichen beizubehalten.This setting also replaces new lines in attributes with character entities to preserve the characters. Dies ist der Standardwert.This is the default value.

  • XmlWriter Die- None Einstellung weist die an, die Eingabe unverändert zu lassen.The None setting tells the XmlWriter to leave the input unchanged. Diese Einstellung wird verwendet, wenn Sie keine neue Zeilen Verarbeitung wünschen.This setting is used when you do not want any new-line processing. Dies ist hilfreich, wenn die Ausgabe von einem XmlReader gelesen wird, der keine Normalisierung durchführt (z XmlTextReader . b. mit Standardeinstellungen).This is useful when the output is read by an XmlReader that does not do any normalization (for example, an XmlTextReader with default settings.)

Die folgenden Tabellen zeigen die Ausgabe WriteString der-Methode, wenn Sie mit dem Eingabe Wert abhängig von der NewLineHandling -Eigenschafts Einstellung angegeben wird.The following tables show the output of the WriteString method when supplied with the input value depending on the NewLineHandling property setting. Die Tabellen zeigen die Ausgabe beim Schreiben von Text Inhalt und auch beim Schreiben eines Attribut Werts.The tables show the output when writing text content and also when writing an attribute value.

Text Node Value:

\r\n\r\n \n\n \r\r \t\t
WurdenEntitize &#D;\n&#D;\n \n\n &#D;&#D; \t\t
Ersetzen vonReplace \r\n\r\n \r\n\r\n \r\n\r\n \t\t
KeineNone \r\n\r\n \n\n \r\r \t\t

Attribute Value:

\r\n\r\n \n\n \r\r \t\t
WurdenEntitize &#D;&#A;&#D;&#A; & #A;&#A; &#D;&#D; 		
Ersetzen vonReplace &#D;&#A;&#D;&#A; & #A;&#A; &#D;&#D; 		
KeineNone \r\n\r\n \n\n \r\r \t\t

Hinweis

Der XmlWriter weist das folgende Verhalten auf, wenn Inhalt innerhalb eines CDATA-Abschnitts, eines Kommentars oder einer Verarbeitungsanweisung geschrieben wird.The XmlWriter has the following behavior when writing content within a CDATA section, comment, or processing instruction. Neue Zeilen werden nie durch ihre Zeichen Entitäten ersetzt, auch wenn NewLineHandling die-Eigenschaft auf Entitizefestgelegt ist.New lines are never replaced with their character entities, even when the NewLineHandling property is set to Entitize. Dies liegt daran, dass Zeichen Entitäten nicht in CDATA-Abschnitten, Kommentaren oder Verarbeitungsanweisungen erkannt werden.This is because character entities are not recognized in CDATA sections, comments or processing instructions. Wenn die NewLineHandling -Eigenschaft auf None oder Replacefestgelegt ist, ist das Verhalten das gleiche wie beim Schreiben eines Textknoten Werts.If the NewLineHandling property is set to None or Replace, the behavior is the same as when writing a text node value.

In der folgenden Tabelle wird beschrieben, was XmlReader eine Normalisierung für die einzelnen Leerraum Eingaben zurückgibt.The following table describes what a normalizing XmlReader returns for each white space input. Weitere Informationen finden Sie in den Abschnitten 2,11 und 3.3.3 der W3C- Empfehlung zu XML 1,0.For more information, see sections 2.11 and 3.3.3 of the W3C XML 1.0 Recommendation.

Hinweis

Ein normalisierender Reader ist XmlReader jedes Objekt, das XmlReader.Create von der-Methode erstellt wird.A normalizing reader is any XmlReader object created by the XmlReader.Create method. Diese Objekte führen immer zu einer Zeilenumbruch Normalisierung und vollständiger Normalisierung von Attributen.These objects always perform line break normalization and full normalization of attributes. Das XmlTextReader -Objekt kann auch ein normalisierender Reader sein, Normalization wenn die-Eigenschaft trueauf festgelegt ist.The XmlTextReader object can also be a normalizing reader if it's Normalization property is set to true.

\r\n\r\n \n\n \r\r \t\t
Text KnotenwertText Node Value \n\n \n\n \n\n \t\t
AttributwertAttribute Value einzelnes Leerzeichensingle space einzelnes Leerzeichensingle space einzelnes Leerzeichensingle space einzelnes Leerzeichensingle space

Gilt für: