XmlWriter.WriteStartDocument Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
En cas de substitution dans une classe dérivée, écrit la déclaration XML.
Surcharges
| WriteStartDocument(Boolean) |
En cas de substitution dans une classe dérivée, écrit la déclaration XML avec la version "1.0" et l'attribut autonome. |
| WriteStartDocument() |
En cas de substitution dans une classe dérivée, écrit la déclaration XML avec la version "1.0". |
Remarques
Pour obtenir la version asynchrone de cette méthode, consultez WriteStartDocumentAsync.
WriteStartDocument(Boolean)
En cas de substitution dans une classe dérivée, écrit la déclaration XML avec la version "1.0" et l'attribut autonome.
public:
abstract void WriteStartDocument(bool standalone);public abstract void WriteStartDocument (bool standalone);abstract member WriteStartDocument : bool -> unitPublic MustOverride Sub WriteStartDocument (standalone As Boolean)Paramètres
- standalone
- Boolean
Si la valeur est true, elle écrit "standalone=yes"; si la valeur est false, elle écrit "standalone=no".
Exceptions
Il ne s'agit pas de la première méthode d'écriture appelée à la suite du constructeur.
- ou -
Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».
Remarques
Le niveau d’encodage du document est déterminé par la façon dont l’enregistreur est implémenté. Par exemple, si un Encoding objet est spécifié dans le XmlTextWriter constructeur, cela détermine la valeur de l’attribut d’encodage.
Lorsqu’il WriteStartDocument est appelé, l’enregistreur valide que ce que vous écrivez est un document XML bien formé. Par exemple, il vérifie que la déclaration XML est le premier nœud, qu’un seul élément de niveau racine existe, et ainsi de suite. Si cette méthode n’est pas appelée, l’enregistreur suppose qu’un fragment XML est écrit et n’applique aucune règle de niveau racine.
Si WriteStartDocument elle a été appelée et que la WriteProcessingInstruction méthode est utilisée pour créer une autre déclaration XML, une exception est levée.
Pour obtenir la version asynchrone de cette méthode, consultez WriteStartDocumentAsync.
S’applique à
WriteStartDocument()
En cas de substitution dans une classe dérivée, écrit la déclaration XML avec la version "1.0".
public:
abstract void WriteStartDocument();public abstract void WriteStartDocument ();abstract member WriteStartDocument : unit -> unitPublic MustOverride Sub WriteStartDocument ()Exceptions
Il ne s'agit pas de la première méthode d'écriture appelée à la suite du constructeur.
- ou -
Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».
Remarques
Le niveau d’encodage du document est déterminé par la façon dont l’enregistreur est implémenté. Par exemple, si un Encoding objet est spécifié dans le XmlTextWriter constructeur, cela détermine la valeur de l’attribut d’encodage. Cette méthode ne crée pas d’attribut autonome.
Lorsqu’on WriteStartDocument appelle l’enregistreur, l’enregistreur valide que ce que vous écrivez est un document XML bien formé. Par exemple, il vérifie que la déclaration XML est le premier nœud, qu’un seul élément de niveau racine existe, et ainsi de suite. Si cette méthode n’est pas appelée, l’enregistreur suppose qu’un fragment XML est écrit et n’applique aucune règle de niveau racine.
Si WriteStartDocument elle a été appelée et que la WriteProcessingInstruction méthode est utilisée pour créer une autre déclaration XML, une exception est levée.
Pour obtenir la version asynchrone de cette méthode, consultez WriteStartDocumentAsync.