XmlWriter Clase

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlWriter.cs

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

public ref class XmlWriter abstract : IAsyncDisposable, IDisposable

public abstract class XmlWriter : IAsyncDisposable, IDisposable

type XmlWriter = class
    interface IAsyncDisposable
    interface IDisposable

Public MustInherit Class XmlWriter
Implements IAsyncDisposable, IDisposable

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

Para obtener más información sobre esta API, consulte comentarios de API complementarias para XmlWriter.

Constructores

XmlWriter()

Inicializa una nueva instancia de la clase XmlWriter.

Propiedades

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

Métodos

Close()	Cuando se invalida en una clase derivada, cierra esta secuencia y la secuencia subyacente.
Create(Stream)	Crea una nueva instancia de XmlWriter mediante la secuencia especificada.
Create(Stream, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante el objeto stream y XmlWriterSettings.
Create(String)	Crea una nueva instancia de XmlWriter con 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 StringBuilderespecificado.
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 TextWriterespecificado.
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 usados por el XmlWriter y, opcionalmente, libera los recursos administrados.
DisposeAsync()	Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o 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 al objeto actual. (Heredado de Object)
Flush()	Cuando se invalida en una clase derivada, vacía lo que se encuentra en el búfer en los flujos subyacentes y también vacía la secuencia subyacente.
FlushAsync()	Vacía de forma asincrónica lo que se encuentra en el búfer en las secuencias subyacentes y también vacía la secuencia subyacente.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
LookupPrefix(String)	Cuando se reemplaza en una clase derivada, devuelve el prefijo más cercano definido en el ámbito del espacio de nombres actual para el URI del espacio de nombres.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
WriteAttributes(XmlReader, Boolean)	Cuando se reemplaza en una clase derivada, escribe todos los atributos que se encuentran en la posición actual de la XmlReader.
WriteAttributesAsync(XmlReader, Boolean)	Escribe de forma asincrónica todos los atributos encontrados en la posición actual del XmlReader.
WriteAttributeString(String, String)	Cuando se invalida en una clase derivada, escribe el atributo con el nombre y el valor locales especificados.
WriteAttributeString(String, String, String)	Cuando se reemplaza en una clase derivada, escribe un atributo con el nombre local, el URI del espacio de nombres y el valor especificados.
WriteAttributeString(String, String, String, String)	Cuando se reemplaza en una clase derivada, escribe el atributo con el prefijo, el nombre local, el URI del espacio de nombres y el valor especificados.
WriteAttributeStringAsync(String, String, String, String)	Escribe de forma asincrónica el atributo con el prefijo, el nombre local, el URI del espacio de nombres y el valor especificados.
WriteBase64(Byte[], Int32, Int32)	Cuando se reemplaza en una clase derivada, codifica los bytes binarios especificados como Base64 y escribe el texto resultante.
WriteBase64Async(Byte[], Int32, Int32)	Codifica de forma asincrónica los bytes binarios especificados como Base64 y escribe el texto resultante.
WriteBinHex(Byte[], Int32, Int32)	Cuando se invalida en una clase derivada, codifica los bytes binarios especificados como BinHex y escribe el texto resultante.
WriteBinHexAsync(Byte[], Int32, Int32)	Codifica de forma asincrónica los bytes binarios especificados como BinHex y escribe el texto resultante.
WriteCData(String)	Cuando se reemplaza en una clase derivada, escribe un <! [CDATA[...]]> bloque que contiene el texto especificado.
WriteCDataAsync(String)	Escribe de forma asincrónica un <! [CDATA[...]]> bloque que contiene el texto especificado.
WriteCharEntity(Char)	Cuando se reemplaza en una clase derivada, fuerza la generación de una entidad de caracteres para el valor de carácter Unicode especificado.
WriteCharEntityAsync(Char)	Fuerza asincrónicamente la generación de una entidad de caracteres para el valor de carácter Unicode especificado.
WriteChars(Char[], Int32, Int32)	Cuando se reemplaza en una clase derivada, escribe texto de un búfer a la vez.
WriteCharsAsync(Char[], Int32, Int32)	Escribe de forma asincrónica un búfer de texto a la vez.
WriteComment(String)	Cuando se reemplaza en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado.
WriteCommentAsync(String)	Escribe de forma asincrónica un comentario <!--...--> que contiene el texto especificado.
WriteDocType(String, String, String, String)	Cuando se reemplaza en una clase derivada, escribe la declaración DOCTYPE con el nombre especificado y los atributos opcionales.
WriteDocTypeAsync(String, String, String, String)	Escribe asincrónicamente la declaración DOCTYPE con el nombre especificado y los atributos opcionales.
WriteElementString(String, String)	Escribe un elemento con el nombre y el valor locales especificados.
WriteElementString(String, String, String)	Escribe un elemento con el nombre local, el URI del espacio de nombres y el valor especificados.
WriteElementString(String, String, String, String)	Escribe un elemento con el prefijo, el nombre local, el URI del espacio de nombres y el valor especificados.
WriteElementStringAsync(String, String, String, String)	Escribe de forma asincrónica un elemento con el prefijo, el nombre local, el URI del espacio de nombres y el valor especificados.
WriteEndAttribute()	Cuando se invalida en una clase derivada, cierra la llamada WriteStartAttribute(String, String) anterior.
WriteEndAttributeAsync()	Cierra de forma asincrónica la llamada de WriteStartAttribute(String, String) anterior.
WriteEndDocument()	Cuando se invalida en una clase derivada, cierra los atributos o elementos abiertos y vuelve a colocar el escritor en el estado Start.
WriteEndDocumentAsync()	Cierra de forma asincrónica los atributos o elementos abiertos y vuelve a colocar el escritor en el estado Inicio.
WriteEndElement()	Cuando se reemplaza en una clase derivada, cierra un elemento y abre el ámbito del espacio de nombres correspondiente.
WriteEndElementAsync()	Cierra de forma asincrónica un elemento y abre el ámbito del espacio de nombres correspondiente.
WriteEntityRef(String)	Cuando se reemplaza en una clase derivada, escribe una referencia de entidad como &name;.
WriteEntityRefAsync(String)	Escribe de forma asincrónica una referencia de entidad como &name;.
WriteFullEndElement()	Cuando se reemplaza en una clase derivada, cierra un elemento y abre el ámbito del espacio de nombres correspondiente.
WriteFullEndElementAsync()	Cierra de forma asincrónica un elemento y abre el ámbito del espacio de nombres correspondiente.
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 W3C XML 1.0 (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
WriteNode(XmlReader, Boolean)	Cuando se reemplaza en una clase derivada, copia todo el contenido del lector al escritor y mueve el lector al principio del siguiente elemento relacionado.
WriteNode(XPathNavigator, Boolean)	Copia todo desde el objeto XPathNavigator al escritor. La posición del XPathNavigator permanece sin cambios.
WriteNodeAsync(XmlReader, Boolean)	Copia de forma asincrónica todo desde el lector hasta el escritor y mueve el lector al principio del siguiente elemento relacionado.
WriteNodeAsync(XPathNavigator, Boolean)	Copia de forma asincrónica todo desde el objeto XPathNavigator al escritor. La posición del XPathNavigator permanece sin cambios.
WriteProcessingInstruction(String, String)	Cuando se reemplaza en una clase derivada, escribe una instrucción de procesamiento con un espacio entre el nombre y el texto de la siguiente manera: <texto ?name?>.
WriteProcessingInstructionAsync(String, String)	Escribe de forma asincrónica una instrucción de procesamiento con un espacio entre el nombre y el texto de la siguiente manera: <texto ?name?>.
WriteQualifiedName(String, String)	Cuando se invalida en una clase derivada, escribe el nombre calificado del espacio de nombres. Este método busca el prefijo que está en el ámbito del espacio de nombres especificado.
WriteQualifiedNameAsync(String, String)	Escribe de forma asincrónica el nombre completo del espacio de nombres. Este método busca el prefijo que está en el ámbito del espacio de nombres especificado.
WriteRaw(Char[], Int32, Int32)	Cuando se reemplaza en una clase derivada, escribe el marcado sin procesar manualmente desde un búfer de caracteres.
WriteRaw(String)	Cuando se reemplaza en una clase derivada, escribe el marcado sin procesar manualmente desde una cadena.
WriteRawAsync(Char[], Int32, Int32)	Escribe de forma asincrónica el marcado sin procesar manualmente desde un búfer de caracteres.
WriteRawAsync(String)	Escribe de forma asincrónica el marcado sin procesar manualmente desde 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 nombre local y el URI del espacio de nombres especificados.
WriteStartAttribute(String, String, String)	Cuando se reemplaza en una clase derivada, escribe el inicio de un atributo con el prefijo, el nombre local y el URI del espacio de nombres especificados.
WriteStartAttributeAsync(String, String, String)	Escribe de forma asincrónica el inicio de un atributo con el prefijo, el nombre local y el URI del espacio de nombres especificados.
WriteStartDocument()	Cuando se reemplaza en una clase derivada, escribe la declaración XML con la versión "1.0".
WriteStartDocument(Boolean)	Cuando se reemplaza en una clase derivada, escribe la declaración XML con la versión "1.0" y el atributo independiente.
WriteStartDocumentAsync()	Escribe de forma asincrónica 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" y el atributo independiente.
WriteStartElement(String)	Cuando se invalida en una clase derivada, escribe una etiqueta start con el nombre local especificado.
WriteStartElement(String, String)	Cuando se reemplaza en una clase derivada, escribe la etiqueta de inicio especificada y la asocia al espacio de nombres especificado.
WriteStartElement(String, String, String)	Cuando se reemplaza en una clase derivada, escribe la etiqueta de inicio especificada y la asocia al espacio de nombres y al prefijo especificados.
WriteStartElementAsync(String, String, String)	Escribe de forma asincrónica la etiqueta de inicio especificada y la asocia al espacio de nombres y al prefijo especificados.
WriteString(String)	Cuando se reemplaza en una clase derivada, escribe el contenido de texto especificado.
WriteStringAsync(String)	Escribe de forma asincrónica el contenido de texto especificado.
WriteSurrogateCharEntity(Char, Char)	Cuando se reemplaza en una clase derivada, genera y escribe la entidad de caracteres suplentes para el par de caracteres suplentes.
WriteSurrogateCharEntityAsync(Char, Char)	Genera y escribe de forma asincrónica la entidad de caracteres suplentes para el par de caracteres suplentes.
WriteValue(Boolean)	Escribe un valor de Boolean.
WriteValue(DateTime)	Escribe un valor de DateTime.
WriteValue(DateTimeOffset)	Escribe un valor de DateTimeOffset.
WriteValue(Decimal)	Escribe un valor de Decimal.
WriteValue(Double)	Escribe un valor de Double.
WriteValue(Int32)	Escribe un valor de Int32.
WriteValue(Int64)	Escribe un valor de 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 de String.
WriteWhitespace(String)	Cuando se invalida en una clase derivada, escribe el espacio en blanco especificado.
WriteWhitespaceAsync(String)	Escribe de forma asincrónica el espacio en blanco especificado.

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.

Consulte también

• documentos XML y de datos