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 ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML.
Overload
| WriteStartDocument(Boolean) |
Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0" e all'attributo standalone. |
| WriteStartDocument() |
Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0". |
Commenti
Per la versione asincrona di questo metodo, vedere WriteStartDocumentAsync.
WriteStartDocument(Boolean)
Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0" e all'attributo standalone.
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 il parametro ha valore true, viene scritto "standalone=yes"; se il parametro ha valore false, viene scritto "standalone=no".
Eccezioni
Non si tratta del primo metodo di scrittura chiamato dopo il costruttore.
-oppure-
È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".
Commenti
Il livello di codifica del documento è determinato dal modo in cui viene implementato il writer. Ad esempio, se nel costruttore viene specificato XmlTextWriter un Encoding oggetto, 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 esiste un solo elemento a livello radice e così via. Se questo metodo non viene chiamato, il writer presuppone che un frammento XML venga scritto 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()
Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0".
public:
abstract void WriteStartDocument();public abstract void WriteStartDocument ();abstract member WriteStartDocument : unit -> unitPublic MustOverride Sub WriteStartDocument ()Eccezioni
Non si tratta del primo metodo di scrittura chiamato dopo il costruttore.
-oppure-
È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".
Commenti
Il livello di codifica del documento è determinato dal modo in cui viene implementato il writer. Ad esempio, se nel costruttore viene specificato XmlTextWriter un Encoding oggetto, questo determina il valore dell'attributo di codifica. Questo metodo non crea un attributo autonomo.
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 esiste un solo elemento a livello radice e così via. Se questo metodo non viene chiamato, il writer presuppone che un frammento XML venga scritto 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.