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
C#
public abstract class XmlWriter : IDisposable
Visual C++
public ref class XmlWriter abstract : IDisposable
F#
[<AbstractClass>]
type XmlWriter =  
    class
        interface IDisposable
    end

El tipo XmlWriter expone los siguientes miembros.

Constructores

  Nombre Descripción
Método protegido Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif XmlWriter Inicializa una nueva instancia de la clase XmlWriter.
Arriba
Propiedades

  Nombre Descripción
Propiedad pública Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Settings Obtiene el objeto XmlWriterSettings que se usa para crear esta instancia de XmlWriter.
Propiedad pública Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteState Cuando se reemplaza en una clase derivada, obtiene el estado del sistema de escritura.
Propiedad pública Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif XmlLang Cuando se reemplaza en una clase derivada, se obtiene el ámbito de xml:lang actual.
Propiedad pública Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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
Método público Compatible con XNA Framework Close Cuando se reemplaza en una clase derivada, cierra esta secuencia y la secuencia subyacente.
Método público Miembro estático Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Create(Stream) Crea una nueva instancia de XmlWriter mediante la secuencia especificada.
Método público Miembro estático Compatible con XNA Framework Create(String) Crea una nueva instancia de XmlWriter mediante el nombre de archivo especificado.
Método público Miembro estático Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Create(StringBuilder) Crea una nueva instancia de XmlWriter mediante el StringBuilder especificado.
Método público Miembro estático Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Create(TextWriter) Crea una nueva instancia de XmlWriter mediante el TextWriter especificado.
Método público Miembro estático Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Create(XmlWriter) Crea una nueva instancia de XmlWriter mediante el objeto XmlWriter especificado.
Método público Miembro estático Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Create(Stream, XmlWriterSettings) Crea una nueva instancia de XmlWriter mediante la secuencia y el objeto XmlWriterSettings.
Método público Miembro estático Compatible con XNA Framework Create(String, XmlWriterSettings) Crea una nueva instancia de XmlWriter mediante el nombre de archivo y el objeto XmlWriterSettings.
Método público Miembro estático Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Create(StringBuilder, XmlWriterSettings) Crea una nueva instancia de XmlWriter mediante los objetos StringBuilder y XmlWriterSettings.
Método público Miembro estático Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Create(TextWriter, XmlWriterSettings) Crea una nueva instancia de XmlWriter usando los objetos TextWriter y XmlWriterSettings.
Método público Miembro estático Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Create(XmlWriter, XmlWriterSettings) Crea una nueva instancia de XmlWriter mediante los objetos XmlWriter y XmlWriterSettings especificados.
Método público 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Dispose()
Método protegido Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Dispose(Boolean) Libera los recursos no administrados que utiliza el objeto XmlWriter y, opcionalmente, los recursos administrados.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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).
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método protegido Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteAttributes Cuando se reemplaza en una clase derivada, escribe todos los atributos que se encuentran en la posición actual en XmlReader.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteAttributeString(String, String) Cuando se reemplaza en una clase derivada, escribe el atributo con el valor y nombre local especificados.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteBase64 Cuando se reemplaza en una clase derivada, codifica los bytes binarios especificados en Base64 y escribe el texto resultante.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteBinHex Cuando se reemplaza en una clase derivada, codifica los bytes binarios especificados en BinHex y escribe el texto resultante.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteCData Cuando se reemplaza en una clase derivada, escribe un bloque <![CDATA[...]]> que contiene el texto especificado.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteChars Cuando se reemplaza en una clase derivada, escribe texto en un búfer cada vez.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteComment Cuando se reemplaza en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteDocType Cuando se reemplaza en una clase derivada, escribe la declaración DOCTYPE con el nombre y atributos opcionales especificados.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteElementString(String, String) Escribe un elemento con el nombre local y el valor especificados.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteElementString(String, String, String) Escribe un elemento con el nombre local especificado, el URI de espacio de nombres y el valor.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteElementString(String, String, String, String) Escribe un elemento con el nombre local especificado, el URI de espacio de nombres y el valor.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteEndAttribute Cuando se reemplaza en una clase derivada, cierra la llamada a WriteStartAttribute anterior.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteEndElement Cuando se reemplaza en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteEntityRef Cuando se invalida en una clase derivada, escribe una referencia a entidad de la siguiente forma: &name;.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteFullEndElement Cuando se reemplaza en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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).
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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).
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público WriteNode(XPathNavigator, Boolean) Copia todo el contenido del objeto XPathNavigator en el sistema de escritura. La posición de XPathNavigator permanece inalterada.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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?>.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteRaw(String) Cuando se reemplaza en una clase derivada, escribe marcado sin formato manualmente desde una cadena.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteRaw(Char[], Int32, Int32) Cuando se reemplaza en una clase derivada, escribe marcado sin formato manualmente desde un búfer de caracteres.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteStartAttribute(String) Escribe el inicio de un atributo con el nombre local especificado.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteStartAttribute(String, String) Escribe el inicio de un atributo con el URI de espacio de nombres y el nombre local especificados.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteStartDocument() Cuando se reemplaza en una clase derivada, escribe la declaración XML con la versión "1.0".
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteStartDocument(Boolean) Cuando se reemplaza en una clase derivada, escribe la declaración XML con la versión "1.0" y el atributo independiente.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteStartElement(String) Cuando se reemplaza en una clase derivada, escribe una etiqueta de apertura con el nombre local especificado.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteStartElement(String, String) Cuando se reemplaza en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres especificado.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif 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.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteString Cuando se reemplaza en una clase derivada, escribe el contenido de texto especificado.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteSurrogateCharEntity Cuando se reemplaza en una clase derivada, genera y escribe la entidad de carácter suplente para el par de caracteres suplentes.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteValue(Boolean) Escribe un valor Boolean.
Método público Compatible con XNA Framework WriteValue(DateTime) Escribe un valor de DateTime.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteValue(Decimal) Escribe un valor Decimal.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteValue(Double) Escribe un valor Double.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteValue(Int32) Escribe un valor Int32.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteValue(Int64) Escribe un valor Int64.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteValue(Object) Escribe el valor del objeto.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteValue(Single) Escribe un número de punto flotante de precisión sencilla.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteValue(String) Escribe un valor String.
Método público Compatible con XNA Framework 5y8188ze.PortableClassLibrary(es-es,VS.100).gif WriteWhitespace Cuando se reemplaza en una clase derivada, escribe el espacio en blanco especificado.
Arriba
Implementaciones explícitas de interfaces

  Nombre Descripción
Implementación explícita de interfaces Método privado Compatible con XNA Framework 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 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 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

Otros recursos