XmlWriter.WriteStartDocument Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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.

C#

public abstract void WriteStartDocument (bool standalone);

Paramètres

standalone

Boolean

Si la valeur est true, elle écrit "standalone=yes"; si la valeur est false, elle écrit "standalone=no".

Exceptions

InvalidOperationException

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.

WriteStartDocument()

En cas de substitution dans une classe dérivée, écrit la déclaration XML avec la version "1.0".

C#

public abstract void WriteStartDocument ();

Exceptions

InvalidOperationException

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.