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.WriteStartDocument ()

 

Data di pubblicazione: ottobre 2016

Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0".

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

public abstract void WriteStartDocument()

Exception Condition
InvalidOperationException

Questo non è il primo metodo di scrittura chiamato dopo il costruttore.

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."

Il livello di codifica del documento è determinato dall'implementazione del writer. Ad esempio, se un Encoding viene specificato nell'oggetto di XmlTextWriter costruttore, viene determinato il valore dell'attributo di codifica. Questo metodo non crea un attributo autonomo.

Quando WriteStartDocument viene chiamato il writer garantisce che si sta scrivendo un documento XML ben formato. Ad esempio, controlla che la dichiarazione XML è il primo nodo, che una, esiste un solo elemento di primo livello e così via. Se non viene chiamato questo metodo, il writer presuppone un frammento XML viene scritto e applica regole di primo livello.

Se WriteStartDocument è stato chiamato e quindi la WriteProcessingInstruction metodo viene utilizzato per creare un'altra dichiarazione XML, verrà generata un'eccezione.

Per la versione asincrona del metodo, vedere WriteStartDocumentAsync.

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: