XmlWriter.WriteStartDocument Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Quando substituído em uma classe derivada, grava a declaração XML.

Sobrecargas

WriteStartDocument(Boolean)	Quando substituído em uma classe derivada, grava a declaração XML com a versão "1.0" e o atributo autônomo.
WriteStartDocument()	Quando substituído em uma classe derivada, grava a declaração XML com a versão "1.0".

Comentários

Para obter a versão assíncrona deste método, consulte WriteStartDocumentAsync.

WriteStartDocument(Boolean)

Quando substituído em uma classe derivada, grava a declaração XML com a versão "1.0" e o atributo autônomo.

public:
 abstract void WriteStartDocument(bool standalone);

public abstract void WriteStartDocument (bool standalone);

abstract member WriteStartDocument : bool -> unit

Public MustOverride Sub WriteStartDocument (standalone As Boolean)

Parâmetros

standalone

Boolean

Se true, grava "standalone=yes"; se false, ele grava "standalone=no".

Exceções

InvalidOperationException

Este não é o primeiro método de gravação chamado após o construtor.

- ou -

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

O nível de codificação do documento é determinado pela forma como o gravador é implementado. Por exemplo, se um Encoding objeto for especificado no XmlTextWriter construtor, isso determinará o valor do atributo de codificação.

Quando WriteStartDocument é chamado, o gravador valida que o que você está escrevendo é um documento XML bem formado. Por exemplo, ele verifica se a declaração XML é o primeiro nó, que existe um elemento de nível raiz e assim por diante. Se esse método não for chamado, o gravador assumirá que um fragmento XML está sendo gravado e não aplicará nenhuma regra de nível raiz.

Se WriteStartDocument tiver sido chamado e o WriteProcessingInstruction método for usado para criar outra declaração XML, uma exceção será gerada.

Para obter a versão assíncrona deste método, consulte WriteStartDocumentAsync.

WriteStartDocument()

Quando substituído em uma classe derivada, grava a declaração XML com a versão "1.0".

public:
 abstract void WriteStartDocument();

public abstract void WriteStartDocument ();

abstract member WriteStartDocument : unit -> unit

Public MustOverride Sub WriteStartDocument ()

Exceções

InvalidOperationException

Este não é o primeiro método de gravação chamado após o construtor.

- ou -

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

O nível de codificação do documento é determinado pela forma como o gravador é implementado. Por exemplo, se um Encoding objeto for especificado no XmlTextWriter construtor, isso determinará o valor do atributo de codificação. Esse método não cria um atributo autônomo.

Quando WriteStartDocument é chamado, o gravador valida que o que você está escrevendo é um documento XML bem formado. Por exemplo, ele verifica se a declaração XML é o primeiro nó, que existe um elemento de nível raiz e assim por diante. Se esse método não for chamado, o gravador assumirá que um fragmento XML está sendo gravado e não aplicará nenhuma regra de nível raiz.

Se WriteStartDocument tiver sido chamado e o WriteProcessingInstruction método for usado para criar outra declaração XML, uma exceção será gerada.

Para obter a versão assíncrona deste método, consulte WriteStartDocumentAsync.