Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo XmlWriter.WriteStartElement (String, String)

 

Data di pubblicazione: ottobre 2016

Quando ne viene eseguito l'override in una classe derivata, scrive il tag di inizio specificato e lo associa allo spazio dei nomi indicato.

Spazio dei nomi:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public void WriteStartElement(
	string localName,
	string ns
)

Parametri

localName
Type: System.String

Nome locale dell'elemento.

ns
Type: System.String

URI dello spazio dei nomi da associare all'elemento. Se questo spazio dei nomi si trova già all'interno dell'ambito ed è associato a un prefisso, il writer scriverà automaticamente anche tale prefisso.

Exception Condition
InvalidOperationException

Il writer viene chiuso.

EncoderFallbackException

È un carattere nel buffer che è un carattere XML valido, ma non è valido per la codifica di output. Ad esempio, se la codifica di output è ASCII, deve utilizzare solo caratteri dell'intervallo da 0 a 127 per i nomi di elementi e attributi. Potrebbe essere il carattere non valido nell'argomento di questo metodo o in un argomento di metodi precedenti che sono state scritte nel buffer. Tali caratteri sono sottoposti a escape riferimenti a entità carattere quando possibile (ad esempio, in nodi di testo o valori di attributo). Tuttavia, il riferimento all'entità di carattere non è consentito nei nomi di elementi e attributi, commenti, istruzioni di elaborazione o sezioni CDATA.

InvalidOperationException

Un XmlWriter metodo è stato chiamato prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "un'operazione asincrona è già in corso."

Dopo aver chiamato questo metodo è possibile scrivere gli attributi o creare del contenuto utilizzando WriteComment, WriteString, o WriteStartElement per gli elementi figlio. È possibile chiudere l'elemento con WriteEndElement o WriteFullEndElement. Ad esempio, il codice c# seguente:

writer.WriteStartElement("item",null);
writer.WriteString("some text");
writer.WriteEndElement();

Genera il seguente output:

<item>some text</item>

Per la versione asincrona del metodo, vedere WriteStartElementAsync.

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: