Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.

Traducción

Original

Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

XmlWriter (Clase)

.NET Framework 4.5

Otras versiones

Representa un sistema de escritura que constituye un medio rápido, no almacenado en caché y de sólo avance para generar secuencias o archivos con datos XML.

Jerarquía de herencia

System.Object
  System.Xml.XmlWriter
    System.Xml.XmlDictionaryWriter
    System.Xml.XmlTextWriter
    System.Xml.Xsl.Runtime.XmlQueryOutput

Espacio de nombres: System.Xml
Ensamblado: System.Xml (en System.Xml.dll)

Sintaxis

C++

public abstract class XmlWriter : IDisposable

El tipo XmlWriter expone los siguientes miembros.

Constructores

	Nombre	Descripción
	XmlWriter	Inicializa una nueva instancia de la clase XmlWriter.

Arriba

Propiedades

	Nombre	Descripción
	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.

Arriba

Métodos

	Nombre	Descripción
	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(String)	Crea una nueva instancia de XmlWriter mediante el nombre de archivo especificado.
	Create(StringBuilder)	Crea una nueva instancia de XmlWriter mediante el objeto StringBuilder especificado.
	Create(TextWriter)	Crea una nueva instancia de XmlWriter mediante el TextWriter especificado.
	Create(XmlWriter)	Crea una nueva instancia de XmlWriter mediante el objeto XmlWriter especificado.
	Create(Stream, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante la secuencia y el objeto XmlWriterSettings.
	Create(String, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante el nombre de archivo y el objeto XmlWriterSettings.
	Create(StringBuilder, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante los objetos StringBuilder y XmlWriterSettings.
	Create(TextWriter, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante los objetos TextWriter y XmlWriterSettings.
	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 utiliza el objeto XmlWriter y, opcionalmente, los recursos administrados.
	Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	Flush	Cuando se invalida en una clase derivada, vuelca el contenido del búfer en las secuencias subyacentes y también vuelca la secuencia subyacente.
	FlushAsync	Vaciados de forma asincrónica contenido en el búfer en las secuencias subyacentes y también vuelca la secuencia subyacente.
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	LookupPrefix	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. (Se hereda de Object).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
	WriteAttributes	Cuando se invalida en una clase derivada, escribe todos los atributos que se encuentran en la posición actual en XmlReader.
	WriteAttributesAsync	Asincrónicamente escribe todos los atributos encontrados en la posición actual en el 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	Escribe el atributo con el prefijo especificado, el nombre local, el URI de espacio de nombres y el valor asincrónicamente.
	WriteBase64	Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en Base64 y escribe el texto resultante.
	WriteBase64Async	Asincrónica codifica los bytes binarios especificados en Base64 y escribe el texto resultante.
	WriteBinHex	Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en BinHex y escribe el texto resultante.
	WriteBinHexAsync	Codifica los bytes binarios especificados como de forma asincrónica BinHex y escribe el texto resultante.
	WriteCData	Cuando se invalida en una clase derivada, escribe un bloque <![CDATA[...]]> que contiene el texto especificado.
	WriteCDataAsync	Escribe asincrónicamente un <![CDATA [...]]> bloque que contiene el texto especificado.
	WriteCharEntity	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	Asincrónicamente impone la generación de una entidad de caracteres para el valor de carácter Unicode especificado.
	WriteChars	Cuando se invalida en una clase derivada, escribe texto en un búfer cada vez.
	WriteCharsAsync	Asincrónicamente escribe texto un búfer a la vez.
	WriteComment	Cuando se invalida en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado.
	WriteCommentAsync	Asincrónicamente escribe un comentario <!--...--> que contiene el texto especificado.
	WriteDocType	Cuando se invalida en una clase derivada, escribe la declaración DOCTYPE con el nombre y atributos opcionales especificados.
	WriteDocTypeAsync	Escribe de forma asincrónica la declaración DOCTYPE con el nombre especificado y los atributos opcionales.
	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 especificado, el nombre local, el URI de espacio de nombres y el valor.
	WriteElementStringAsync	Escribe de forma asincrónica un elemento con el prefijo especificado, el nombre local, el URI de espacio de nombres y el valor.
	WriteEndAttribute	Cuando se invalida en una clase derivada, cierra la llamada a WriteStartAttribute anterior.
	WriteEndAttributeAsync	Asincrónicamente cierra la anterior WriteStartAttribute llamar.
	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	Asincrónicamente cierra cualquier abrir elementos o atributos y vuelve a colocar 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	Asincrónica cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
	WriteEntityRef	Cuando se invalida en una clase derivada, escribe una referencia a entidad de la siguiente forma: &name;.
	WriteEntityRefAsync	Asincrónicamente escribe una referencia de entidad como &name;.
	WriteFullEndElement	Cuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
	WriteFullEndElementAsync	Asincrónica cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
	WriteName	Cuando se invalida en una clase derivada, escribe el nombre especificado, comprobando que sea un nombre válido de acuerdo con la recomendación relativa a XML 1.0 del Consorcio W3C (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
	WriteNameAsync	Asincrónicamente escribe el nombre especificado, asegurando que es un nombre válido según la recomendación 1.0 de XML del Consorcio W3C (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
	WriteNmToken	Cuando se invalida en una clase derivada, escribe el nombre especificado, comprobando que sea un NmToken válido de acuerdo con la recomendación relativa a XML 1.0 del Consorcio W3C (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).
	WriteNmTokenAsync	Asincrónicamente escribe el nombre especificado, asegurando que es un NmToken válido de acuerdo con la recomendación 1.0 de XML del Consorcio W3C (http://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)	Asincrónica copia todo el contenido del lector en el sistema de escritura y desplaza el lector al inicio del siguiente nodo relacionado.
	WriteNodeAsync(XPathNavigator, Boolean)	Asincrónicamente, copia todo el contenido de la XPathNavigator objeto en el sistema de escritura. La posición de XPathNavigator permanece inalterada.
	WriteProcessingInstruction	Cuando se reemplaza en una clase derivada, escribe una instrucción de procesamiento con un espacio entre el nombre y el texto: <? nombre texto?>.
	WriteProcessingInstructionAsync	¿Asincrónicamente escribe una instrucción de procesamiento con un espacio entre el nombre y el texto siguiente: <? nombre texto?>.
	WriteQualifiedName	Cuando se invalida en una clase derivada, escribe el nombre completo de espacio de nombres. Este método busca el prefijo que está en el ámbito del espacio de nombres especificado.
	WriteQualifiedNameAsync	Escribe el nombre completo del espacio de nombres forma asincrónica. Este método busca el prefijo que está en el ámbito del espacio de nombres especificado.
	WriteRaw(String)	Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde una cadena.
	WriteRaw(Char[], Int32, Int32)	Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde un búfer de caracteres.
	WriteRawAsync(String)	Asincrónicamente manualmente escribe marcado sin formato desde una cadena.
	WriteRawAsync(Char[], Int32, Int32)	Asincrónicamente manualmente escribe marcado sin formato de un búfer de caracteres.
	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	Asincrónicamente escribe el inicio de un atributo con el prefijo especificado, el nombre local y el identificador URI de espacio de nombres.
	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 de forma asincrónica la declaración XML con la versión "1.0".
	WriteStartDocumentAsync(Boolean)	Asincrónicamente escribe 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 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	Asincrónica escribe la etiqueta de apertura especificada y lo asocia con el espacio de nombres y prefijo.
	WriteString	Cuando se invalida en una clase derivada, escribe el contenido de texto especificado.
	WriteStringAsync	Forma asincrónica, escribe el contenido de texto especificado.
	WriteSurrogateCharEntity	Cuando se invalida en una clase derivada, genera y escribe la entidad de carácter suplente para el par de caracteres suplentes.
	WriteSurrogateCharEntityAsync	Genera de forma asincrónica y escribe la entidad para el par de caracteres suplentes de carácter.
	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	Cuando se invalida en una clase derivada, escribe el espacio en blanco especificado.
	WriteWhitespaceAsync	Escribe asincrónicamente el espacio en blanco especificado.

Arriba

Implementaciones explícitas de interfaces

	Nombre	Descripción
	IDisposable.Dispose	Para obtener una descripción de este miembro, vea IDisposable.Dispose.

Arriba

Comentarios

La clase XmlWriter admite el Lenguaje de marcado extensible (XML) 1.0 y los espacios de nombres de las recomendaciones XML del Consorcio W3C.

Nota
Aunque Microsoft .NET Framework incluye la clase XmlTextWriter, que es una implementación de la clase XmlWriter, en la versión 2.0, se recomienda utilizar el método Create para crear nuevos objetos XmlWriter. El método Create permite especificar las características compatibles con el objeto XmlWriter creado y, además, permite aprovechar al máximo las ventajas de las nuevas características presentadas en la versión 2.0.

Nota

Aunque Microsoft .NET Framework incluye la clase XmlTextWriter, que es una implementación de la clase XmlWriter, en la versión 2.0, se recomienda utilizar el método Create para crear nuevos objetos XmlWriter. El método Create permite especificar las características compatibles con el objeto XmlWriter creado y, además, permite aprovechar al máximo las ventajas de las nuevas características presentadas en la versión 2.0.

Nota
Cuando utiliza los métodos de XmlWriter para la salida XML, los elementos y atributos no se escriben hasta que se llama al método Close. Por ejemplo, si utiliza XmlWriter para rellenar un XmlDocument, no podrá observar los elementos y atributos escritos en el documento de destino hasta que cierre el XmlWriter.

Para obtener más información sobre la clase XmlWriter, vea Writing XML with the XmlWriter.

No todos los métodos sincrónicos tienen un método asincrónico equivalente. La tabla siguiente muestra el uso asincrónico equivalente para los métodos sincrónicos.

Método sincrónico	Código de método asincrónico equivalente
WriteStartAttribute y WriteEndAttribute	Uso WriteAttributeStringAsync método en su lugar
WriteValue	Convertir el valor en cadena y llamar a la WriteStringAsync método

Consideraciones de seguridad

Debe tener en cuenta los elementos siguientes a la hora de trabajar con la clase XmlWriter.

Las excepciones iniciadas por XmlWriter pueden revelar información de ruta de acceso que quizás no desee traspasar a la aplicación. Las aplicaciones deben detectar las excepciones y procesarlas correctamente.
XmlWriter no valida ningún dato que se pase a los métodos WriteDocType o WriteRaw. No debe pasar datos arbitrarios a estos métodos.

Ejemplos

Ejemplo de código siguiente muestra cómo utilizar la API asíncrona 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();
    }
}

Información de versión

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

System.Xml (Espacio de nombres)

Otros recursos

XML Documents and Data

Security and Your System.Xml Applications

¿Te ha resultado útil? Sí No

No es preciso

No es lo suficientemente profundo

Se necesitan ejemplos de código adicionales

La traducción necesita mejoras

(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR