Freigeben über


XmlWriterSettings.NewLineHandling Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob Zeilenumbrüche in der Ausgabe normalisiert werden sollen, oder legt diesen fest.

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. Der Standardwert ist Replace.

Hinweise

Diese Einstellung gilt beim Schreiben von Textinhalts- oder Attributwerten. Jeder der NewLineHandling Werte wird unten beschrieben:

  • Die Entitize Einstellung weist den XmlWriter an, neue Zeilenzeichen zu ersetzen, die andernfalls nicht durch eine Normalisierung XmlReader mit Zeichenentitäten beibehalten würden. Dies ist in Roundtripszenarien nützlich, in denen die Ausgabe durch eine Normalisierung XmlReadergelesen wird. Zusätzliche Normalisierungsregeln gelten für Attributwerte beim Roundtrip seit \tund \n\r werden durch ein Leerzeichen in Attributwerten ersetzt, wenn sie in einem XmlReadernormalisiert werden.

  • Die Replace Einstellung weist den XmlWriter an, neue Zeilenzeichen durch die in der NewLineChars -Eigenschaft spezifischen Zeichen zu ersetzen. Diese Einstellung ersetzt auch neue Zeilen in Attributen durch Zeichenentitäten, um die Zeichen beizubehalten. Es ist auch der Standardwert.

  • Die None Einstellung weist den XmlWriter an, die Eingabe unverändert zu lassen. Diese Einstellung wird verwendet, wenn Sie keine Neuzeilenverarbeitung wünschen. Dies ist nützlich, wenn die Ausgabe von einem XmlReader gelesen wird, das keine Normalisierung durchführt (z. B. ein XmlTextReader mit Standardeinstellungen).

Die folgenden Tabellen zeigen die Ausgabe der WriteString Methode, wenn sie mit dem Eingabewert abhängig von der NewLineHandling Eigenschaftseinstellung angegeben wird. Die Tabellen zeigen die Ausgabe beim Schreiben von Textinhalt und auch beim Schreiben eines Attributwerts an.

Text Node Value:

\r\n \n \r \t
Entitize &#D;\n \n &#D; \t
Replace \r\n \r\n \r\n \t
Keine \r\n \n \r \t

Attribute Value:

\r\n \n \r \t
Entitize &#D;&#A; &#A; &#D;
Replace &#D;&#A; &#A; &#D;
Keine \r\n \n \r \t

Hinweis

Beim XmlWriter Schreiben von Inhalten in einem CDATA-Abschnitt, Einem Kommentar oder einer Verarbeitungsanweisung weist das folgende Verhalten auf. Neue Zeilen werden nie durch ihre Zeichenentitäten ersetzt, auch wenn die NewLineHandling -Eigenschaft auf Entitizefestgelegt ist. Dies liegt daran, dass Zeichenentitäten in CDATA-Abschnitten, Kommentaren oder Verarbeitungsanweisungen nicht erkannt werden. Wenn die NewLineHandling Eigenschaft auf None oder Replacefestgelegt ist, ist das Verhalten identisch mit dem Schreiben eines Textknotenwerts.

In der folgenden Tabelle wird beschrieben, was eine Normalisierung XmlReader für jede Leerraumeingabe zurückgibt. Weitere Informationen finden Sie in den Abschnitten 2.11 und 3.3.3 der W3C XML 1.0-Empfehlung.

Hinweis

Ein normalisierender Reader ist ein beliebiges XmlReader Objekt, das von der XmlReader.Create -Methode erstellt wird. Diese Objekte führen immer die Normalisierung von Zeilenumbrüchen und die vollständige Normalisierung von Attributen durch. Das XmlTextReader Objekt kann auch ein normalisierender Normalization Reader sein, wenn seine Eigenschaft auf truefestgelegt ist.

\r\n \n \r \t
Textknotenwert \n \n \n \t
Attributwert Einzelner Leerraum Einzelner Leerraum Einzelner Leerraum Einzelner Leerraum

Gilt für: