Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlWriter.WriteStartDocument méthode ()

 

Date de publication : novembre 2016

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

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

public abstract void WriteStartDocument()

Exception Condition
InvalidOperationException

Cela n’est pas la première méthode d’écriture appelée après le constructeur.

InvalidOperationException

Un XmlWriter méthode a été appelée avant la fin d'une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « une opération asynchrone est déjà en cours. »

Le niveau d’encodage du document est déterminé par le mode d’implémentation du writer. Par exemple, si un Encoding objet est spécifié dans le XmlTextWriter constructeur, ce paramètre détermine la valeur de l’attribut d’encodage. Cette méthode ne crée pas d’attribut autonome.

Lorsque WriteStartDocument est appelé le writer valide 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 et un seul élément de niveau racine existe et ainsi de suite. Si cette méthode n’est pas appelée, le writer suppose qu’un fragment XML est écrit et n’applique aucune règle de niveau racine.

Si WriteStartDocument a été appelée, puis la WriteProcessingInstruction méthode est utilisée pour créer une autre déclaration XML, une exception sera levée.

Pour obtenir la version asynchrone de cette méthode, consultez la page WriteStartDocumentAsync.

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: