XmlWriter.WriteStartDocument Methode

Definitie

Naamruimte:

System.Xml

Assembly's:

netstandard.dll, System.Xml.ReaderWriter.dll

Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u de XML-declaratie.

Overloads

Name	Description
WriteStartDocument(Boolean)	Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u de XML-declaratie met versie 1.0 en het zelfstandige kenmerk.
WriteStartDocument()	Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u de XML-declaratie met versie 1.0.

Opmerkingen

Zie voor de asynchrone versie van deze methode WriteStartDocumentAsync.

WriteStartDocument(Boolean)

Bron:

XmlWriter.cs

Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u de XML-declaratie met versie 1.0 en het zelfstandige kenmerk.

public:
 abstract void WriteStartDocument(bool standalone);

public abstract void WriteStartDocument(bool standalone);

abstract member WriteStartDocument : bool -> unit

Public MustOverride Sub WriteStartDocument (standalone As Boolean)

Parameters

standalone

Boolean

Als true, schrijft het "standalone =ja"; als false, schrijft het "standalone =nee".

Uitzonderingen

InvalidOperationException

Dit is niet de eerste schrijfmethode die wordt aangeroepen na de constructor.

– of –

Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

Opmerkingen

Het coderingsniveau van het document wordt bepaald door de wijze waarop de schrijver wordt geïmplementeerd. Als een object bijvoorbeeld Encoding is opgegeven in de XmlTextWriter constructor, bepaalt dit de waarde van het coderingskenmerk.

Wanneer WriteStartDocument wordt aangeroepen, valideert de schrijver of wat u schrijft een goed opgemaakt XML-document is. Er wordt bijvoorbeeld gecontroleerd of de XML-declaratie het eerste knooppunt is, dat er maar één element op hoofdniveau bestaat, enzovoort. Als deze methode niet wordt aangeroepen, gaat de schrijver ervan uit dat er een XML-fragment wordt geschreven en geen regels op hoofdniveau worden toegepast.

Als WriteStartDocument de methode is aangeroepen en vervolgens WriteProcessingInstruction wordt gebruikt om een andere XML-declaratie te maken, wordt er een uitzondering gegenereerd.

Zie voor de asynchrone versie van deze methode WriteStartDocumentAsync.

WriteStartDocument()

Bron:

XmlWriter.cs

Wanneer deze wordt overschreven in een afgeleide klasse, schrijft u de XML-declaratie met versie 1.0.

public:
 abstract void WriteStartDocument();

public abstract void WriteStartDocument();

abstract member WriteStartDocument : unit -> unit

Public MustOverride Sub WriteStartDocument ()

Uitzonderingen

InvalidOperationException

Dit is niet de eerste schrijfmethode die wordt aangeroepen na de constructor.

– of –

Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

Opmerkingen

Het coderingsniveau van het document wordt bepaald door de wijze waarop de schrijver wordt geïmplementeerd. Als een object bijvoorbeeld Encoding is opgegeven in de XmlTextWriter constructor, bepaalt dit de waarde van het coderingskenmerk. Met deze methode wordt geen zelfstandig kenmerk gemaakt.

Wanneer WriteStartDocument de schrijver wordt genoemd, wordt gevalideerd of wat u schrijft een goed opgemaakt XML-document is. Er wordt bijvoorbeeld gecontroleerd of de XML-declaratie het eerste knooppunt is, dat er maar één element op hoofdniveau bestaat, enzovoort. Als deze methode niet wordt aangeroepen, gaat de schrijver ervan uit dat er een XML-fragment wordt geschreven en geen regels op hoofdniveau worden toegepast.

Als WriteStartDocument de methode is aangeroepen en vervolgens WriteProcessingInstruction wordt gebruikt om een andere XML-declaratie te maken, wordt er een uitzondering gegenereerd.

Zie voor de asynchrone versie van deze methode WriteStartDocumentAsync.