XmlWriter.WriteStartDocument Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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 -> unitPublic 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.