XmlWriter (Clase) (System.Xml)

Cambiar vista:

Sin script

Biblioteca de clases de .NET Framework

XmlWriter (Clase)

Este artículo se tradujo de forma manual. Para mostrar esta página y el contenido original en inglés al mismo tiempo, cambie a Lightweight según sus preferencias de visualización.

Representa un sistema de escritura que constituye un medio rápido, no almacenado en caché y de solo 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

Visual Basic

Public MustInherit Class XmlWriter _
	Implements IDisposable

public abstract class XmlWriter : IDisposable

Visual C++

public ref class XmlWriter abstract : IDisposable

[<AbstractClass>]
type XmlWriter =  
    class
        interface IDisposable
    end

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 reemplaza en una clase derivada, obtiene el estado del sistema de escritura.
	XmlLang	Cuando se reemplaza en una clase derivada, se obtiene el ámbito de xml:lang actual.
	XmlSpace	Cuando se reemplaza 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 reemplaza 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 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 usando los objetos TextWriter y XmlWriterSettings.
	Create(XmlWriter, XmlWriterSettings)	Crea una nueva instancia de XmlWriter mediante los objetos XmlWriter y XmlWriterSettings especificados.
	Dispose()
	Dispose(Boolean)	Libera los recursos no administrados que utiliza el objeto XmlWriter y, opcionalmente, los recursos administrados.
	Equals(Object)	Determina si el objeto Object especificado es igual al objeto Object 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 reemplaza en una clase derivada, vuelca el contenido del 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 reemplaza 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 objeto Object actual. (Se hereda de Object).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
	WriteAttributes	Cuando se reemplaza en una clase derivada, escribe todos los atributos que se encuentran en la posición actual en XmlReader.
	WriteAttributeString(String, String)	Cuando se reemplaza en una clase derivada, escribe el atributo con el valor y nombre local especificados.
	WriteAttributeString(String, String, String)	Cuando se reemplaza 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 reemplaza en una clase derivada, escribe el atributo con el prefijo, el nombre local, el identificador URI de espacio de nombres y el valor especificados.
	WriteBase64	Cuando se reemplaza en una clase derivada, codifica los bytes binarios especificados en Base64 y escribe el texto resultante.
	WriteBinHex	Cuando se reemplaza en una clase derivada, codifica los bytes binarios especificados en BinHex y escribe el texto resultante.
	WriteCData	Cuando se reemplaza en una clase derivada, escribe un bloque <![CDATA[...]]> que contiene el texto especificado.
	WriteCharEntity	Cuando se reemplaza en una clase derivada, impone la generación de una entidad de caracteres para el valor de carácter Unicode especificado.
	WriteChars	Cuando se reemplaza en una clase derivada, escribe texto en un búfer cada vez.
	WriteComment	Cuando se reemplaza en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado.
	WriteDocType	Cuando se reemplaza en una clase derivada, escribe la declaración DOCTYPE con el nombre y 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 nombre local especificado, el URI de espacio de nombres y el valor.
	WriteEndAttribute	Cuando se reemplaza en una clase derivada, cierra la llamada a WriteStartAttribute anterior.
	WriteEndDocument	Cuando se reemplaza en una clase derivada, cierra todos los elementos o atributos abiertos y vuelve a colocar el sistema de escritura en el estado de inicio.
	WriteEndElement	Cuando se reemplaza en una clase derivada, 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;.
	WriteFullEndElement	Cuando se reemplaza en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
	WriteName	Cuando se reemplaza 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).
	WriteNmToken	Cuando se reemplaza 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).
	WriteNode(XmlReader, Boolean)	Cuando se reemplaza 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.
	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?>.
	WriteQualifiedName	Cuando se reemplaza 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.
	WriteRaw(String)	Cuando se reemplaza en una clase derivada, escribe marcado sin formato manualmente desde una cadena.
	WriteRaw(Char[], Int32, Int32)	Cuando se reemplaza en una clase derivada, escribe marcado sin formato manualmente desde 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 reemplaza en una clase derivada, escribe el inicio de un atributo con el prefijo, el nombre local y el URI de 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.
	WriteStartElement(String)	Cuando se reemplaza en una clase derivada, escribe una etiqueta de apertura con el nombre local especificado.
	WriteStartElement(String, String)	Cuando se reemplaza en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres especificado.
	WriteStartElement(String, String, String)	Cuando se reemplaza en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres y prefijo especificados.
	WriteString	Cuando se reemplaza en una clase derivada, escribe el contenido de texto especificado.
	WriteSurrogateCharEntity	Cuando se reemplaza en una clase derivada, genera y escribe la entidad de carácter suplente para el par de caracteres suplentes.
	WriteValue(Boolean)	Escribe un valor Boolean.
	WriteValue(DateTime)	Escribe un valor de DateTime.
	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 reemplaza en una clase derivada, escribe 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 Escribir XML con XmlWriter.

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.

Información de versión

.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:

Plataformas

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.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

Documentos y datos XML

Seguridad y aplicaciones System.Xml