XmlWriter Clase

Definición

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
XmlWriter
Derivado
Implementaciones

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 complementarios de la API para XmlWriter.

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 reemplaza 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