XmlWriter.WriteStartDocument Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Quando sottoposto a override in una classe derivata, scrive la dichiarazione XML.
Overload
| Nome | Descrizione |
|---|---|
| WriteStartDocument() |
In caso di override in una classe derivata, scrive la dichiarazione XML con la versione "1.0". |
| WriteStartDocument(Boolean) |
In caso di override in una classe derivata, scrive la dichiarazione XML con la versione "1.0" e l'attributo autonomo. |
Commenti
Per la versione asincrona di questo metodo, vedere WriteStartDocumentAsync.
WriteStartDocument()
In caso di override in una classe derivata, scrive la dichiarazione XML con la versione "1.0".
public:
abstract void WriteStartDocument();public abstract void WriteStartDocument();abstract member WriteStartDocument : unit -> unitPublic MustOverride Sub WriteStartDocument ()Eccezioni
Questo non è il primo metodo di scrittura chiamato dopo il costruttore.
oppure
È stato chiamato un XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".
Commenti
Il livello di codifica del documento è determinato dal modo in cui viene implementato il writer. Ad esempio, se un Encoding oggetto viene specificato nel XmlTextWriter costruttore, questo determina il valore dell'attributo di codifica. Questo metodo non crea un attributo autonomo.
Quando WriteStartDocument viene chiamato il writer verifica che ciò che si sta scrivendo sia un documento XML ben formato. Ad esempio, verifica che la dichiarazione XML sia il primo nodo, che esista un solo elemento di livello radice e così via. Se questo metodo non viene chiamato, il writer presuppone che venga scritto un frammento XML e non applichi regole a livello radice.
Se WriteStartDocument è stato chiamato e quindi viene usato il WriteProcessingInstruction metodo per creare un'altra dichiarazione XML, verrà generata un'eccezione.
Per la versione asincrona di questo metodo, vedere WriteStartDocumentAsync.
Si applica a
WriteStartDocument(Boolean)
In caso di override in una classe derivata, scrive la dichiarazione XML con la versione "1.0" e l'attributo autonomo.
public:
abstract void WriteStartDocument(bool standalone);public abstract void WriteStartDocument(bool standalone);abstract member WriteStartDocument : bool -> unitPublic MustOverride Sub WriteStartDocument (standalone As Boolean)Parametri
- standalone
- Boolean
Se true, scrive "standalone=yes"; se false, scrive "standalone=no".
Eccezioni
Questo non è il primo metodo di scrittura chiamato dopo il costruttore.
oppure
È stato chiamato un XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".
Commenti
Il livello di codifica del documento è determinato dal modo in cui viene implementato il writer. Ad esempio, se un Encoding oggetto viene specificato nel XmlTextWriter costruttore, questo determina il valore dell'attributo di codifica.
Quando WriteStartDocument viene chiamato, il writer convalida che ciò che si sta scrivendo è un documento XML ben formato. Ad esempio, verifica che la dichiarazione XML sia il primo nodo, che esista un solo elemento di livello radice e così via. Se questo metodo non viene chiamato, il writer presuppone che venga scritto un frammento XML e non applichi regole a livello radice.
Se WriteStartDocument è stato chiamato e quindi viene usato il WriteProcessingInstruction metodo per creare un'altra dichiarazione XML, verrà generata un'eccezione.
Per la versione asincrona di questo metodo, vedere WriteStartDocumentAsync.