XmlWriterSettings.NewLineHandling Proprietà

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origine:

XmlWriterSettings.cs

Ottiene o imposta un valore che indica se le interruzioni di riga devono essere normalizzate nell'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

Valore della proprietà

NewLineHandling

Uno dei valori di NewLineHandling. Il valore predefinito è Replace.

Commenti

Questa impostazione si applica durante la scrittura di contenuto di testo o valori di attributo. Ognuno dei valori è descritto di NewLineHandling seguito:

• L'impostazione Entitize indica a di XmlWriter sostituire i nuovi caratteri di riga che non verrebbero altrimenti mantenuti da una normalizzazione XmlReader con entità carattere. Ciò è utile negli scenari di round trip in cui l'output viene letto da una normalizzazione XmlReaderdi . Le regole di normalizzazione aggiuntive si applicano ai valori degli attributi quando si esegue il round trip da e \t\n\r vengono sostituiti con uno spazio nei valori degli attributi quando normalizzati in un oggetto .XmlReader

• L'impostazione Replace indica a di XmlWriter sostituire i nuovi caratteri di riga con i caratteri specifici nella NewLineChars proprietà . Questa impostazione sostituisce anche le nuove righe negli attributi con le entità carattere per mantenere i caratteri. È anche il valore predefinito.

• L'impostazione None indica a di XmlWriter lasciare invariato l'input. Questa impostazione viene utilizzata quando non si desidera elaborare alcuna nuova riga. Ciò è utile quando l'output viene letto da un XmlReader oggetto che non esegue alcuna normalizzazione (ad esempio, con XmlTextReader le impostazioni predefinite).

Le tabelle seguenti mostrano l'output del WriteString metodo quando viene fornito con il valore di input a seconda dell'impostazione della NewLineHandling proprietà. Le tabelle mostrano l'output durante la scrittura di contenuto di testo e anche quando si scrive un valore di attributo.

Text Node Value:

	\r\n	\n	\r	\t
Entitize	&#D;\n	\n	&#D;	\t
Sostituisci	\r\n	\r\n	\r\n	\t
nessuno	\r\n	\n	\r	\t

Attribute Value:

	\r\n	\n	\r	\t
Entitize	&#D;&#A;	&#A;	&#D;
Sostituisci	&#D;&#A;	&#A;	&#D;
nessuno	\r\n	\n	\r	\t

Nota

L'oggetto XmlWriter ha il comportamento seguente durante la scrittura di contenuto all'interno di una sezione, un commento o un'istruzione di elaborazione CDATA. Le nuove righe non vengono mai sostituite con le relative entità carattere, anche quando la NewLineHandling proprietà è impostata su Entitize. Ciò è dovuto al fatto che le entità carattere non vengono riconosciute nelle sezioni CDATA, nei commenti o nelle istruzioni di elaborazione. Se la NewLineHandling proprietà è impostata su None o Replace, il comportamento è uguale a quando si scrive un valore di nodo di testo.

Nella tabella seguente viene descritto cosa restituisce una normalizzazione XmlReader per ogni input di spazio vuoto. Per altre informazioni, vedere le sezioni 2.11 e 3.3.3 della raccomandazione W3C XML 1.0.

Nota

Un lettore di normalizzazione è qualsiasi XmlReader oggetto creato dal XmlReader.Create metodo . Questi oggetti eseguono sempre la normalizzazione dell'interruzione di riga e la normalizzazione completa degli attributi. L'oggetto XmlTextReader può anche essere un lettore normalizzato se la Normalization proprietà è impostata su true.

	\r\n	\n	\r	\t
Valore nodo di testo	\n	\n	\n	\t
Valore dell'attributo	spazio singolo	spazio singolo	spazio singolo	spazio singolo