XmlWriter Clase

Referencia

Definición

Espacio de nombres:: System.Xml

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: System.Xml.dll

Ensamblado:: netstandard.dll

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í.

Representa un sistema de escritura que constituye una manera rápida, no almacenada en caché y de solo avance para generar flujos o archivos que contienen datos XML.

public ref class XmlWriter abstract : IDisposable

public ref class XmlWriter abstract : IAsyncDisposable, IDisposable

public ref class XmlWriter abstract

public abstract class XmlWriter : IDisposable

public abstract class XmlWriter : IAsyncDisposable, IDisposable

public abstract class XmlWriter

type XmlWriter = class
    interface IDisposable

type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable

type XmlWriter = class

Public MustInherit Class XmlWriter
Implements IDisposable

Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable

Public MustInherit Class XmlWriter

Herencia: Object
XmlWriter

Derivado: System.Xml.XmlDictionaryWriter

System.Xml.XmlTextWriter

System.Xml.Xsl.Runtime.XmlQueryOutput

Implementaciones: IDisposable IAsyncDisposable

Ejemplos

En el código de ejemplo siguiente se muestra cómo usar la API asincrónica para generar XML.

async Task TestWriter(Stream stream)   
{  
    XmlWriterSettings settings = new XmlWriterSettings();  
    settings.Async = true;  

    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {  
        await writer.WriteStartElementAsync("pf", "root", "http://ns");  
        await writer.WriteStartElementAsync(null, "sub", null);  
        await writer.WriteAttributeStringAsync(null, "att", null, "val");  
        await writer.WriteStringAsync("text");  
        await writer.WriteEndElementAsync();  
        await writer.WriteProcessingInstructionAsync("pName", "pValue");  
        await writer.WriteCommentAsync("cValue");  
        await writer.WriteCDataAsync("cdata value");  
        await writer.WriteEndElementAsync();  
        await writer.FlushAsync();  
    }  
}

Comentarios

La XmlWriter clase escribe datos XML en una secuencia, un archivo, un lector de texto o una cadena. Admite las recomendaciones de W3C para el lenguaje de marcado extensible XML 1.0 (cuarta edición) y los espacios de nombres en XML 1.0 (tercera edición).

Los miembros de la XmlWriter clase le permiten:

Comprobar que los caracteres son caracteres legales XML y que los nombres de elemento y atributo son nombres XML válidos.
Comprobar que el documento XML tiene el formato correcto.
Codifique bytes binarios como Base64 o BinHex y escriba el texto resultante.
Pase valores mediante tipos de Common Language Runtime en lugar de cadenas, para evitar tener que realizar manualmente conversiones de valores.
Escribir varios documentos en un flujo de salida.
Escribir nombres válidos, nombres completos y tokens de nombres.

En esta sección:

Creación de un sistema de escritura XML
Especificar el formato de salida
Conformidad de datos
Escritura de elementos
Escritura de atributos
Control de espacios de nombres
Escribir datos con tipo
Cerrar el sistema de escritura XML
Programación asincrónica
Consideraciones de seguridad

Creación de un sistema de escritura XML

Para crear una XmlWriter instancia, use el XmlWriter.Create método . Para especificar el conjunto de características que desea habilitar en el sistema de escritura XML, pase un XmlWriterSettings al Create método . De lo contrario, se usa la configuración predeterminada. Consulte las Create páginas de referencia para obtener más información.

Especificar el formato de salida

La XmlWriterSettings clase incluye varias propiedades que controlan cómo XmlWriter se da formato a la salida:

Propiedad.	Descripción
Encoding	Especifica la codificación de texto que se va a utilizar. De manera predeterminada, es `Encoding.UTF8`.
Indent	Indica si se van a aplicar sangrías a los elementos. El valor predeterminado es `false` (sin sangría).
IndentChars	Especifica la cadena de caracteres que se va a utilizar para aplicar la sangría. El valor predeterminado es dos espacios.
NewLineChars	Especifica la cadena de caracteres que se va a utilizar para los saltos de línea. El valor predeterminado es `\r\n` (retorno de carro, avance de línea).
NewLineHandling	Especifica cómo controlar caracteres de nueva línea.
NewLineOnAttributes	Indica si se van a escribir atributos en una línea nueva. Indent debe establecerse `true` en al usar esta propiedad. De manera predeterminada, es `false`.
OmitXmlDeclaration	Indica si se va a escribir una declaración XML. De manera predeterminada, es `false`.

Las propiedades Indent y IndentChars controlan cómo se da formato al espacio en blanco que es poco importante. Por ejemplo, en nodos de elemento de sangría:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("books.xml", settings);

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

NewLineOnAttributes Use para escribir cada atributo en una nueva línea con un nivel adicional de sangría:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.NewLineOnAttributes = true;
XmlWriter writer = XmlWriter.Create("books.xml", settings);

Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.NewLineOnAttributes = True
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Conformidad de datos

Un escritor XML usa dos propiedades de la XmlWriterSettings clase para comprobar la conformidad de los datos:

La CheckCharacters propiedad indica al escritor XML que compruebe los caracteres y genere una XmlException excepción si alguno de los caracteres está fuera del intervalo legal, tal como se define en el W3C.

La ConformanceLevel propiedad configura el sistema de escritura XML para comprobar que la secuencia que se está escribiendo cumple con las reglas de un documento o fragmento de documento XML 1.0 bien formado, tal y como se define en el W3C. Los tres niveles de conformidad se describen en la tabla siguiente. De manera predeterminada, es Document. Para obtener más información, vea la XmlWriterSettings.ConformanceLevel propiedad y la System.Xml.ConformanceLevel enumeración.

Nivel	Descripción
Document	La salida XML se ajusta a las reglas de un documento XML 1.0 bien formado y se puede procesar mediante cualquier procesador conforme.
Fragment	La salida XML se ajusta a las reglas de un fragmento de documento XML 1.0 correcto.
Auto	El escritor XML determina qué nivel de comprobación de conformación se va a aplicar (documento o fragmento) en función de los datos entrantes.

Escritura de elementos

Puede usar los métodos siguientes XmlWriter para escribir nodos de elemento. Para obtener ejemplos, consulte los métodos enumerados.

Usar	En
WriteElementString	Escriba un nodo de elemento completo, incluido un valor de cadena.
WriteStartElement	Para escribir un valor de elemento mediante varias llamadas de método. Por ejemplo, puede llamar a WriteValue para escribir un valor con establecimiento de tipos, a WriteCharEntity para escribir una entidad de caracteres, a WriteAttributeString para escribir un atributo o puede escribir un elemento secundario. Se trata de una versión más sofisticada del WriteElementString método . Para cerrar el elemento, llame al WriteEndElement método o WriteFullEndElement .
WriteNode	Para copiar un nodo de elemento encontrado en la posición actual de un XmlReader objeto o XPathNavigator . Cuando se llama, copia todo del objeto de origen en la instancia de XmlWriter.

Escritura de atributos

Puede usar los métodos siguientes XmlWriter para escribir atributos en nodos de elemento. Estos métodos también se pueden usar para crear declaraciones de espacio de nombres en un elemento, como se describe en la sección siguiente.

Usar	En
WriteAttributeString	Para escribir un nodo de atributo completo, incluido un valor de cadena.
WriteStartAttribute	Para escribir el valor del atributo mediante varias llamadas de método. Por ejemplo, puede llamar WriteValue a para escribir un valor con tipo. Se trata de una versión más sofisticada del WriteElementString método . Para cerrar el elemento, llame al WriteEndAttribute método .
WriteAttributes	Para copiar todos los atributos encontrados en la posición actual de un XmlReader objeto. Los atributos escritos dependen del tipo de nodo en el que se coloca actualmente el lector: - Para un nodo de atributo, escribe el atributo actual y, a continuación, el resto de los atributos hasta la etiqueta de cierre del elemento. - Para un nodo de elemento, escribe todos los atributos incluidos en el elemento . - Para un nodo de declaración XML, escribe todos los atributos de la declaración. - Para todos los demás tipos de nodo, el método produce una excepción.

Control de espacios de nombres

Los espacios de nombres se utilizan para calificar nombres de atributos y elementos en un documento XML. Los prefijos de espacio de nombres asocian elementos y atributos con espacios de nombres, que a su vez están asociados a referencias de URI. Los espacios de nombres crean nombres de elementos y atributos únicos en un documento XML.

XmlWriter mantiene una pila de espacios de nombres que corresponde a todos los espacios de nombres definidos en el ámbito del espacio de nombres actual. A la hora de escribir elementos y atributos, puede utilizar espacios de nombres de las siguientes formas:

Declare los espacios de nombres manualmente mediante el WriteAttributeString método . Esto puede resultar útil si conoce la mejor forma de optimizar el número de declaraciones de espacios de nombres. Para obtener un ejemplo, vea el WriteAttributeString(String, String, String, String) método .

Invalidar la declaración de espacio de nombres actual con un espacio de nombres nuevo. En el código siguiente, el WriteAttributeString método cambia el URI del espacio de nombres del "x" prefijo de "123" a "abc".

writer.WriteStartElement("x", "root", "123");
writer.WriteStartElement("item");
writer.WriteAttributeString("xmlns", "x", null, "abc");
writer.WriteEndElement();
writer.WriteEndElement();

writer.WriteStartElement("x", "root", "123")
writer.WriteStartElement("item")
writer.WriteAttributeString("xmlns", "x", Nothing, "abc")
writer.WriteEndElement()
writer.WriteEndElement()

El código genera la siguiente cadena XML:

<x:root xmlns:x="123">  
  <item xmlns:x="abc" />  
</x:root>

Especifique un prefijo de espacio de nombres al escribir atributos o elementos. Muchos de los métodos usados para escribir elementos y atributos le permiten hacerlo. Por ejemplo, el WriteStartElement(String, String, String) método escribe una etiqueta de inicio y la asocia con un espacio de nombres y un prefijo especificados.

Escribir datos con tipo

El WriteValue método acepta un objeto de Common Language Runtime (CLR), convierte el valor de entrada en su representación de cadena según las reglas de conversión de tipos de datos del lenguaje de definición de esquema XML (XSD) y lo escribe mediante el WriteString método . Esto es más fácil que usar los métodos de la XmlConvert clase para convertir los datos con tipo en un valor de cadena antes de escribirlos.

Al escribir en texto, el valor con tipo se serializa en texto mediante las XmlConvert reglas para ese tipo de esquema.

Para conocer los tipos de datos XSD predeterminados que corresponden a los tipos CLR, consulte el WriteValue método .

XmlWriter También se puede usar para escribir en un almacén de datos XML. Por ejemplo, la clase XPathNavigator puede crear un objeto XmlWriter para crear nodos para un objeto XmlDocument. Si el almacén de datos tiene información de esquema disponible, el WriteValue método produce una excepción si intenta convertir a un tipo que no está permitido. Si el almacén de datos no tiene información de esquema disponible, el WriteValue método trata todos los valores como un xsd:anySimpleType tipo.

Cerrar el sistema de escritura XML

Cuando se usan XmlWriter métodos para generar XML, los elementos y atributos no se escriben hasta que se llama al Close método . Por ejemplo, si usa XmlWriter para rellenar un XmlDocument objeto, no podrá ver los elementos y atributos escritos en el documento de destino hasta que cierre la XmlWriter instancia.

Programación asincrónica

La mayoría de los XmlWriter métodos tienen homólogos asincrónicos que tienen "Async" al final de sus nombres de método. Por ejemplo, el equivalente asincrónico de WriteAttributeString es WriteAttributeStringAsync.

Para el WriteValue método , que no tiene un homólogo asincrónico, convierta el valor devuelto en una cadena y use el WriteStringAsync método en su lugar.

Consideraciones de seguridad

Tenga en cuenta lo siguiente al trabajar con la XmlWriter clase :

Las excepciones producidas por XmlWriter pueden revelar la información de ruta de acceso que no desea que se produzca una burbuja en la aplicación. La aplicación debe detectar excepciones y procesarlas correctamente.
XmlWriter no valida ningún dato que se pase al WriteDocType método o WriteRaw . No debe pasar datos arbitrarios a estos métodos.

Constructores

XmlWriter()

Inicializa una nueva instancia de la clase XmlWriter.

Propiedades

Settings	Obtiene el objeto XmlWriterSettings que se usa para crear esta instancia de XmlWriter.
WriteState	Cuando se invalida en una clase derivada, obtiene el estado del sistema de escritura.
XmlLang	Cuando se invalida en una clase derivada, obtiene el ámbito de `xml:lang` actual.
XmlSpace	Cuando se invalida en una clase derivada, se obtiene un XmlSpace que representa el ámbito de `xml:space` actual.

Métodos

Close()	Cuando se invalida en una clase derivada, cierra este flujo y el flujo subyacente.
Create(Stream)	Crea una nueva instancia de XmlWriter mediante la secuencia especificada.
Create(Stream, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante la secuencia y el objeto XmlWriterSettings.
Create(String)	Crea una nueva instancia de XmlWriter mediante el nombre de archivo especificado.
Create(String, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante el nombre de archivo y el objeto XmlWriterSettings.
Create(StringBuilder)	Crea una nueva instancia de XmlWriter mediante el objeto StringBuilder especificado.
Create(StringBuilder, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante los objetos StringBuilder y XmlWriterSettings.
Create(TextWriter)	Crea una nueva instancia de XmlWriter mediante el objeto TextWriter especificado.
Create(TextWriter, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante los objetos TextWriter y XmlWriterSettings.
Create(XmlWriter)	Crea una nueva instancia de XmlWriter mediante el objeto XmlWriter especificado.
Create(XmlWriter, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante los objetos XmlWriter y XmlWriterSettings especificados.
Dispose()	Libera todos los recursos usados por la instancia actual de la clase XmlWriter.
Dispose(Boolean)	Libera los recursos no administrados que usa XmlWriter y, de forma opcional, libera los recursos administrados.
DisposeAsync()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados de forma asincrónica.
DisposeAsyncCore()	Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o restablecimiento de recursos administrados de forma asincrónica.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Flush()	Cuando se invalida en una clase derivada, vuelca el contenido del búfer en los flujos subyacentes y también vuelca el flujo subyacente.
FlushAsync()	Vuelca asincrónicamente el contenido del búfer en los flujos subyacentes y también vuelca el flujo subyacente.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
LookupPrefix(String)	Cuando se invalida en una clase derivada, devuelve el prefijo más próximo definido en el ámbito de espacio de nombres actual correspondiente al identificador URI de espacio de nombres.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
WriteAttributes(XmlReader, Boolean)	Cuando se invalida en una clase derivada, escribe todos los atributos que se encuentran en la posición actual en XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	De forma asincrónica escribe todos los atributos encontrados en la posición actual en XmlReader.
WriteAttributeString(String, String)	Cuando se invalida en una clase derivada, escribe el atributo con el valor y nombre local especificados.
WriteAttributeString(String, String, String)	Cuando se invalida en una clase derivada, escribe un atributo con el valor, nombre local e identificador URI del espacio de nombres especificados.
WriteAttributeString(String, String, String, String)	Cuando se invalida en una clase derivada, escribe el atributo con el prefijo, el nombre local, el identificador URI de espacio de nombres y el valor especificados.
WriteAttributeStringAsync(String, String, String, String)	Escribe asincrónicamente un atributo con el prefijo, el nombre local, el URI del espacio de nombres y el valor especificados.
WriteBase64(Byte[], Int32, Int32)	Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en Base64 y escribe el texto resultante.
WriteBase64Async(Byte[], Int32, Int32)	Codifica asincrónicamente los bytes binarios especificados en Base64 y escribe el texto resultante.
WriteBinHex(Byte[], Int32, Int32)	Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en `BinHex` y escribe el texto resultante.
WriteBinHexAsync(Byte[], Int32, Int32)	Codifica asincrónicamente los bytes binarios especificados como `BinHex` y escribe el texto resultante.
WriteCData(String)	Cuando se invalida en una clase derivada, escribe un bloque <![CDATA[...]]> que contiene el texto especificado.
WriteCDataAsync(String)	Escribe asincrónicamente un bloque <![CDATA[...]]> que contiene el texto especificado.
WriteCharEntity(Char)	Cuando se invalida en una clase derivada, impone la generación de una entidad de caracteres para el valor de carácter Unicode especificado.
WriteCharEntityAsync(Char)	Impone asincrónicamente la generación de una entidad de caracteres para el valor de carácter Unicode especificado.
WriteChars(Char[], Int32, Int32)	Cuando se invalida en una clase derivada, escribe texto en un búfer cada vez.
WriteCharsAsync(Char[], Int32, Int32)	Escribe asincrónicamente texto en un búfer cada vez.
WriteComment(String)	Cuando se invalida en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado.
WriteCommentAsync(String)	De forma asincrónica escribe un comentario <!--...--> que contiene el texto especificado.
WriteDocType(String, String, String, String)	Cuando se invalida en una clase derivada, escribe la declaración DOCTYPE con el nombre y atributos opcionales especificados.
WriteDocTypeAsync(String, String, String, String)	Escribe asincrónicamente la declaración DOCTYPE con el nombre y los atributos opcionales especificados.
WriteElementString(String, String)	Escribe un elemento con el nombre local y el valor especificados.
WriteElementString(String, String, String)	Escribe un elemento con el nombre local especificado, el URI de espacio de nombres y el valor.
WriteElementString(String, String, String, String)	Escribe un elemento con el prefijo, nombre local, el URI de espacio de nombres y el valor especificados.
WriteElementStringAsync(String, String, String, String)	Escribe asincrónicamente un elemento con el nombre local, el URI de espacio de nombres, el valor y el prefijo especificados.
WriteEndAttribute()	Cuando se invalida en una clase derivada, cierra la llamada a WriteStartAttribute(String, String) anterior.
WriteEndAttributeAsync()	Cierra de forma asincrónica la llamada anterior al método WriteStartAttribute(String, String) .
WriteEndDocument()	Cuando se invalida en una clase derivada, cierra todos los elementos o atributos abiertos y vuelve a colocar el sistema de escritura en el estado de inicio.
WriteEndDocumentAsync()	Cierra asincrónicamente todos los elementos o atributos abiertos y coloca de nuevo el sistema de escritura en el estado de inicio.
WriteEndElement()	Cuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
WriteEndElementAsync()	Cierra asincrónicamente un elemento y extrae el correspondiente ámbito de espacio de nombres.
WriteEntityRef(String)	Cuando se invalida en una clase derivada, escribe una referencia a entidad de la siguiente forma: `&name;`.
WriteEntityRefAsync(String)	De forma asincrónica coloca una referencia de entidad en tipo como `&name;`.
WriteFullEndElement()	Cuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
WriteFullEndElementAsync()	Cierra asincrónicamente un elemento y extrae el correspondiente ámbito de espacio de nombres.
WriteName(String)	Cuando se invalida en una clase derivada, escribe el nombre especificado, asegurándose de que es un nombre válido según la recomendación W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNameAsync(String)	Escribe de forma asincrónica el nombre especificado, asegurándose de que es un nombre válido según la recomendación XML 1.0 de W3C (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmToken(String)	Cuando se invalida en una clase derivada, escribe el nombre especificado, asegurándose de que es un NmToken válido según la recomendación W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNmTokenAsync(String)	Escribe de forma asincrónica el nombre especificado, asegurándose de que es un NmToken válido según la recomendación XML 1.0 de W3C (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	Cuando se invalida en una clase derivada, copia todo el contenido del lector en el sistema de escritura y desplaza el lector al inicio del siguiente nodo relacionado.
WriteNode(XPathNavigator, Boolean)	Copia todo el contenido del objeto XPathNavigator en el sistema de escritura. La posición de XPathNavigator permanece inalterada.
WriteNodeAsync(XmlReader, Boolean)	Copia asincrónicamente todo el contenido del lector en el sistema de escritura y desplaza el lector al inicio del siguiente nodo relacionado.
WriteNodeAsync(XPathNavigator, Boolean)	De forma asincrónica copia todo el objeto de XPathNavigator al escritor. La posición de XPathNavigator permanece inalterada.
WriteProcessingInstruction(String, String)	Cuando se invalida en una clase derivada, escribe una instrucción de procesamiento con un espacio entre el nombre y el texto: <?nombre texto?>.
WriteProcessingInstructionAsync(String, String)	Escribe de forma asincrónica una instrucción de procesamiento con un espacio entre el nombre y el texto: <?nombre texto?>.
WriteQualifiedName(String, String)	Cuando se invalida en una clase derivada, escribe el nombre completo del espacio de nombres. Este método busca un prefijo que está en el ámbito del espacio de nombres especificado.
WriteQualifiedNameAsync(String, String)	Escribe asincrónicamente el nombre completo del espacio de nombres. Este método busca un prefijo que está en el ámbito del espacio de nombres especificado.
WriteRaw(Char[], Int32, Int32)	Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde un búfer de caracteres.
WriteRaw(String)	Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde una cadena.
WriteRawAsync(Char[], Int32, Int32)	Escribe asincrónicamente el marcado sin formato de un búfer de caracteres.
WriteRawAsync(String)	Escribe asincrónicamente el marcado sin formato de una cadena.
WriteStartAttribute(String)	Escribe el inicio de un atributo con el nombre local especificado.
WriteStartAttribute(String, String)	Escribe el inicio de un atributo con el URI de espacio de nombres y el nombre local especificados.
WriteStartAttribute(String, String, String)	Cuando se invalida en una clase derivada, escribe el inicio de un atributo con el prefijo, el nombre local y el URI de espacio de nombres especificados.
WriteStartAttributeAsync(String, String, String)	Escribe asincrónicamente el inicio de un atributo con el prefijo, URI de espacio de nombres y el nombre local especificados.
WriteStartDocument()	Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0".
WriteStartDocument(Boolean)	Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0" y el atributo independiente.
WriteStartDocumentAsync()	Escribe asincrónicamente la declaración XML con la versión "1.0".
WriteStartDocumentAsync(Boolean)	Escribe asincrónicamente la declaración XML con la versión "1.0" así como el atributo independiente.
WriteStartElement(String)	Cuando se invalida en una clase derivada, escribe una etiqueta de apertura con el nombre local especificado.
WriteStartElement(String, String)	Cuando se invalida en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres especificado.
WriteStartElement(String, String, String)	Cuando se invalida en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres y prefijo especificados.
WriteStartElementAsync(String, String, String)	Escribe asincrónicamente la etiqueta de apertura especificada y la asocia al espacio de nombres y al prefijo especificados.
WriteString(String)	Cuando se invalida en una clase derivada, escribe el contenido de texto especificado.
WriteStringAsync(String)	Escribe asincrónicamente el contenido de texto dado.
WriteSurrogateCharEntity(Char, Char)	Cuando se invalida en una clase derivada, genera y escribe la entidad de carácter suplente para el par de caracteres suplentes.
WriteSurrogateCharEntityAsync(Char, Char)	Genera y escribe asincrónicamente la entidad de carácter suplente del par de caracteres suplentes.
WriteValue(Boolean)	Escribe un valor Boolean.
WriteValue(DateTime)	Escribe un valor DateTime.
WriteValue(DateTimeOffset)	Escribe un valor DateTimeOffset.
WriteValue(Decimal)	Escribe un valor Decimal.
WriteValue(Double)	Escribe un valor Double.
WriteValue(Int32)	Escribe un valor Int32.
WriteValue(Int64)	Escribe un valor Int64.
WriteValue(Object)	Escribe el valor del objeto.
WriteValue(Single)	Escribe un número de punto flotante de precisión sencilla.
WriteValue(String)	Escribe un valor String.
WriteWhitespace(String)	Cuando se invalida en una clase derivada, escribe el espacio en blanco especificado.
WriteWhitespaceAsync(String)	Escribe asincrónicamente el espacio en blanco especificado.

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Para obtener una descripción de este miembro, vea Dispose().

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable.

Se aplica a

Consulte también

Documentos y datos XML