XmlWriter.WriteStartDocument Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic MustOverride Sub WriteStartDocument (standalone As Boolean)Parâmetros
- standalone
- Boolean
Se true, grava "standalone=yes"; se false, ele grava "standalone=no".
Exceções
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.
Aplica-se a
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 -> unitPublic MustOverride Sub WriteStartDocument ()Exceções
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.