Partager via


XmlWriter.WriteStartDocument Méthode

Définition

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 -> unit
Public 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 -> unit
Public 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.

S’applique à