Compartir a través de


XmlWriter.WriteStartDocument Método

Definición

Cuando se invalida en una clase derivada, escribe la declaración XML.

Sobrecargas

WriteStartDocument(Boolean)

Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0" y el atributo independiente.

WriteStartDocument()

Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0".

Comentarios

Para obtener la versión asincrónica de este método, vea WriteStartDocumentAsync.

WriteStartDocument(Boolean)

Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0" y el atributo independiente.

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

Si es true, escribirá "standalone=yes"; si es false, escribirá "standalone=no".

Excepciones

Este no es el primer método Write al que se llama después de llamar al constructor.

o bien

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Comentarios

El nivel de codificación del documento viene determinado por cómo se implementa el escritor. Por ejemplo, si se especifica un Encoding objeto en el XmlTextWriter constructor, determina el valor del atributo de codificación.

Cuando WriteStartDocument se llama a , el escritor valida que lo que está escribiendo es un documento XML bien formado. Por ejemplo, comprueba que la declaración XML es el primer nodo, que existe uno y solo un elemento de nivel raíz, etc. Si no se llama a este método, el escritor supone que se está escribiendo un fragmento XML y no aplica ninguna regla de nivel raíz.

Si WriteStartDocument se ha llamado a y, a continuación, se usa el WriteProcessingInstruction método para crear otra declaración XML, se producirá una excepción.

Para obtener la versión asincrónica de este método, vea WriteStartDocumentAsync.

Se aplica a

WriteStartDocument()

Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0".

public:
 abstract void WriteStartDocument();
public abstract void WriteStartDocument ();
abstract member WriteStartDocument : unit -> unit
Public MustOverride Sub WriteStartDocument ()

Excepciones

Este no es el primer método Write al que se llama después de llamar al constructor.

o bien

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Comentarios

El nivel de codificación del documento viene determinado por cómo se implementa el escritor. Por ejemplo, si se especifica un Encoding objeto en el XmlTextWriter constructor, determina el valor del atributo de codificación. Este método no crea un atributo independiente.

Cuando WriteStartDocument se llama al escritor, se valida que lo que está escribiendo es un documento XML bien formado. Por ejemplo, comprueba que la declaración XML es el primer nodo, que existe uno y solo un elemento de nivel raíz, etc. Si no se llama a este método, el escritor supone que se está escribiendo un fragmento XML y no aplica ninguna regla de nivel raíz.

Si WriteStartDocument se ha llamado a y, a continuación, se usa el WriteProcessingInstruction método para crear otra declaración XML, se producirá una excepción.

Para obtener la versión asincrónica de este método, vea WriteStartDocumentAsync.

Se aplica a