Exportar (0) Imprimir
Expandir todo
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

XmlWriter (Clase)

Representa un programador que proporciona un método rápido, sin almacenamiento en memoria caché, adelantada - sólo de generar secuencias o archivos que contienen datos XML.

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

public abstract class XmlWriter : IDisposable

El tipo XmlWriter expone los siguientes miembros.

  NombreDescripción
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsXmlWriterInicializa una nueva instancia de la clase XmlWriter.
Arriba

  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsSettingsObtiene el objeto XmlWriterSettings que se usa para crear esta instancia de XmlWriter.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStateCuando se invalida en una clase derivada, obtiene el estado del sistema de escritura.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsXmlLangCuando se invalida en una clase derivada, obtiene el ámbito de xml:lang actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsXmlSpaceCuando se invalida en una clase derivada, se obtiene un XmlSpace que representa el ámbito de xml:space actual.
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCloseCuando se invalida en una clase derivada, cierra esta secuencia y la secuencia subyacente.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(Stream)Crea una nueva instancia de XmlWriter mediante la secuencia especificada.
Método públicoMiembro estáticoCompatible con XNA FrameworkCreate(String)Crea una nueva instancia de XmlWriter mediante el nombre de archivo especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(StringBuilder)Crea una nueva instancia de XmlWriter mediante el objeto StringBuilder especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(TextWriter)Crea una nueva instancia de XmlWriter mediante el TextWriter especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(XmlWriter)Crea una nueva instancia de XmlWriter mediante el objeto XmlWriter especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(Stream, XmlWriterSettings)Crea una nueva instancia de XmlWriter mediante la secuencia y el objeto XmlWriterSettings.
Método públicoMiembro estáticoCompatible con XNA FrameworkCreate(String, XmlWriterSettings)Crea una nueva instancia de XmlWriter mediante el nombre de archivo y el objeto XmlWriterSettings.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(StringBuilder, XmlWriterSettings)Crea una nueva instancia de XmlWriter mediante los objetos StringBuilder y XmlWriterSettings.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(TextWriter, XmlWriterSettings)Crea una nueva instancia de XmlWriter mediante los objetos TextWriter y XmlWriterSettings.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(XmlWriter, XmlWriterSettings)Crea una nueva instancia de XmlWriter mediante los objetos XmlWriter y XmlWriterSettings especificados.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsDispose()Libera todos los recursos usados por la instancia actual de la clase XmlWriter.
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsDispose(Boolean)Libera los recursos no administrados que utiliza el objeto XmlWriter y, opcionalmente, los recursos administrados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFinalize 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úblicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFlushCuando se invalida en una clase derivada, vuelca el contenido del búfer en las secuencias subyacentes y también vuelca la secuencia subyacente.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsFlushAsyncVuelca asincrónicamente el contenido del búfer en las secuencias subyacentes y también vuelca la secuencia subyacente.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsLookupPrefixCuando 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.
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteAttributesCuando se invalida en una clase derivada, escribe todos los atributos que se encuentran en la posición actual en XmlReader.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteAttributesAsyncDe forma asincrónica escribe todos los atributos encontrados en la posición actual en XmlReader.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteAttributeString(String, String)Cuando se invalida en una clase derivada, escribe el atributo con el valor y nombre local especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteAttributeString(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteAttributeString(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.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteAttributeStringAsyncEscribe asincrónicamente un atributo con el prefijo, el nombre local, el URI del espacio de nombres y el valor especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteBase64Cuando se invalida en una clase derivada, codifica los bytes binarios especificados en Base64 y escribe el texto resultante.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteBase64AsyncCodifica asincrónicamente los bytes binarios especificados en Base64 y escribe el texto resultante.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteBinHexCuando se invalida en una clase derivada, codifica los bytes binarios especificados en BinHex y escribe el texto resultante.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteBinHexAsyncCodifica asincrónicamente los bytes binarios especificados como BinHex y escribe el texto resultante.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteCDataCuando se invalida en una clase derivada, escribe un bloque <![CDATA[...]]> que contiene el texto especificado.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteCDataAsyncEscribe asincrónicamente un bloque <![CDATA[...]]> que contiene el texto especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteCharEntityCuando se invalida en una clase derivada, impone la generación de una entidad de caracteres para el valor de carácter Unicode especificado.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteCharEntityAsyncImpone asincrónicamente la generación de una entidad de caracteres para el valor de carácter Unicode especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteCharsCuando se invalida en una clase derivada, escribe texto en un búfer cada vez.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteCharsAsyncEscribe asincrónicamente texto en un búfer cada vez.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteCommentCuando se invalida en una clase derivada, escribe un comentario <!--...--> que contiene el texto especificado.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteCommentAsyncDe forma asincrónica escribe un comentario <!--...--> que contiene el texto especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteDocTypeCuando se invalida en una clase derivada, escribe la declaración DOCTYPE con el nombre y atributos opcionales especificados.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteDocTypeAsyncEscribe asincrónicamente la declaración DOCTYPE con el nombre y los atributos opcionales especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteElementString(String, String)Escribe un elemento con el nombre local y el valor especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteElementString(String, String, String)Escribe un elemento con el nombre local especificado, el URI de espacio de nombres y el valor.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteElementString(String, String, String, String)Escribe un elemento con el prefijo, nombre local, el URI de espacio de nombres y el valor especificados.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteElementStringAsyncEscribe asincrónicamente un elemento con el nombre local, el URI de espacio de nombres, el valor y el prefijo especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteEndAttributeCuando se invalida en una clase derivada, cierra la llamada a WriteStartAttribute anterior.
Método protegidoCompatible con .NET para aplicaciones de la Tienda WindowsWriteEndAttributeAsyncCierra de forma asincrónica la llamada anterior al método WriteStartAttribute .
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteEndDocumentCuando 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.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteEndDocumentAsyncCierra asincrónicamente todos los elementos o atributos abiertos y coloca de nuevo el sistema de escritura en el estado de inicio.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteEndElementCuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteEndElementAsyncCierra asincrónicamente un elemento y extrae el correspondiente ámbito de espacio de nombres.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteEntityRefCuando se invalida en una clase derivada, escribe una referencia a entidad de la siguiente forma: &name;.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteEntityRefAsyncDe forma asincrónica coloca una referencia de entidad en tipo como &name;.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteFullEndElementCuando se invalida en una clase derivada, cierra un elemento y extrae el ámbito de espacio de nombres correspondiente.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteFullEndElementAsyncCierra asincrónicamente un elemento y extrae el correspondiente ámbito de espacio de nombres.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteNameCuando 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).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteNameAsyncEscribe asincrónicamente el nombre especificado, asegurando que se trata de 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úblicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteNmTokenCuando 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).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteNmTokenAsyncEscribe asincrónicamente asincrónicamente el nombre especificado, asegurando que se trata de 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úblicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteNode(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.
Método públicoWriteNode(XPathNavigator, Boolean)Copia todo el contenido del objeto XPathNavigator en el sistema de escritura. La posición de XPathNavigator permanece inalterada.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteNodeAsync(XmlReader, Boolean)Cuando se invalida en una clase derivada, copia asincrónicamente todo el contenido del lector en el sistema de escritura y desplaza el lector al inicio del siguiente nodo relacionado.
Método públicoWriteNodeAsync(XPathNavigator, Boolean)De forma asincrónica copia todo el objeto de XPathNavigator al escritor. La posición de XPathNavigator permanece inalterada.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteProcessingInstructionCuando se invalida en una clase derivada, escribe una instrucción de procesamiento con un espacio entre el nombre y el texto: <?nombre texto?>.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteProcessingInstructionAsyncEscribe asincrónicamente una instrucción de procesamiento con un espacio entre el nombre y el texto: <?nombre texto?>.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteQualifiedNameCuando 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.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteQualifiedNameAsyncEscribe asincrónicamente el nombre completo del espacio de nombres. Este método busca el prefijo que está en el ámbito del espacio de nombres especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteRaw(String)Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde una cadena.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteRaw(Char[], Int32, Int32)Cuando se invalida en una clase derivada, escribe marcado sin formato manualmente desde un búfer de caracteres.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteRawAsync(String)Escribe asincrónicamente el marcado sin formato de una cadena.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteRawAsync(Char[], Int32, Int32)Escribe asincrónicamente el marcado sin formato de un búfer de caracteres.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartAttribute(String)Escribe el inicio de un atributo con el nombre local especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartAttribute(String, String)Escribe el inicio de un atributo con el URI de espacio de nombres y el nombre local especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartAttribute(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.
Método protegidoCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartAttributeAsyncEscribe asincrónicamente el inicio de un atributo con el prefijo, URI de espacio de nombres y el nombre local especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartDocument()Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0".
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartDocument(Boolean)Cuando se invalida en una clase derivada, escribe la declaración XML con la versión "1.0" y el atributo independiente.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartDocumentAsync()Escribe asincrónicamente la declaración XML con la versión "1.0".
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartDocumentAsync(Boolean)Escribe asincrónicamente la declaración XML con la versión "1.0" así como el atributo independiente.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartElement(String)Cuando se invalida en una clase derivada, escribe una etiqueta de apertura con el nombre local especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartElement(String, String)Cuando se invalida en una clase derivada, escribe la etiqueta de apertura especificada y la asocia al espacio de nombres especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartElement(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.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteStartElementAsyncEscribe asincrónicamente la etiqueta de apertura especificada y la asocia al espacio de nombres y al prefijo especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteStringCuando se invalida en una clase derivada, escribe el contenido de texto especificado.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteStringAsyncEscribe asincrónicamente el contenido de texto dado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteSurrogateCharEntityCuando se invalida en una clase derivada, genera y escribe la entidad de carácter suplente para el par de caracteres suplentes.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteSurrogateCharEntityAsyncGenera y escribe asincrónicamente la entidad de carácter suplente del par de caracteres suplentes.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(Boolean)Escribe un valor Boolean.
Método públicoCompatible con XNA FrameworkWriteValue(DateTime)Escribe un valor DateTime.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(DateTimeOffset)Escribe un valor DateTimeOffset.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(Decimal)Escribe un valor Decimal.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(Double)Escribe un valor Double.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(Int32)Escribe un valor Int32.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(Int64)Escribe un valor Int64.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(Object)Escribe el valor del objeto.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(Single)Escribe un número de punto flotante de precisión sencilla.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteValue(String)Escribe un valor String.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteWhitespaceCuando se invalida en una clase derivada, escribe el espacio en blanco especificado.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsWriteWhitespaceAsyncEscribe asincrónicamente el espacio en blanco especificado.
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoCompatible con XNA FrameworkIDisposable.DisposePara obtener una descripción de este miembro, vea IDisposable.Dispose.
Arriba

La clase de XmlWriter escribe datos XML en una secuencia, un archivo, un lector de texto, o una cadena. Admite W3C Lenguaje de marcado extensible (XML) 1,0 (cuarta edición) y Espacios de nombres en XML 1,0 (tercera edición) recomendaciones.

Los miembros de la clase de XmlWriter le permiten:

  • Comprobar que los caracteres son caracteres legales XML y que los nombres de elemento y atributo son nombres XML válidos.

  • Comprobar que el documento XML tiene el formato correcto.

  • Codifique los bytes binarios como Base64 o Binhex, y coloque el texto en tipo resultante.

  • Pase los valores utilizando tipos de Common Language Runtime en lugar de cadenas, para evitar tener que manualmente realizar conversiones de valores.

  • Escribir varios documentos en un flujo de salida.

  • Escribir nombres válidos, nombres completos y tokens de nombres.

En esta sección:

Crear un sistema de escritura XML
Especificar el formato de salida
Compatibilidad con los datos
Elementos de escritura
Atributos de escritura
Administrar espacios de nombres
Escritura de datos con tipo
Cerrando el sistema de escritura XML
Programación asincrónica
Consideraciones de seguridad

Crear un sistema de escritura XML

Para crear una instancia de XmlWriter , utilice el método de XmlWriter.Create . Para especificar el conjunto de características que desea habilitar en el sistema de escritura XML, pase XmlWriterSettings al método de Create . Si no, se utilizará la configuración predeterminada. Vea las páginas de referencia de Create para obtener detalles.

Especificar el formato de salida

La clase de XmlWriterSettings incluye varias propiedades que controlan cómo se da formato a la salida de XmlWriter :

Propiedad

Descripción

Encoding

Especifica la codificación de texto que se va a utilizar. El valor predeterminado es Encoding.UTF8.

Indent

Indica si se van a aplicar sangrías a los elementos. El valor predeterminado es false (ninguna sangría).

IndentChars

Especifica la cadena de caracteres que se va a utilizar para aplicar la sangría. El valor predeterminado es dos espacios.

NewLineChars

Especifica la cadena de caracteres que se va a utilizar para los saltos de línea. El valor predeterminado es \r\n (retorno de carro, avance de línea).

NewLineHandling

Especifica cómo controlar los caracteres de nueva línea.

NewLineOnAttributes

Indica si se van a escribir atributos en una línea nueva. Indent se debería establecer en true si se utiliza esta propiedad. El valor predeterminado es false.

OmitXmlDeclaration

Indica si se va a escribir una declaración XML. El valor predeterminado es false.

Las propiedades Indent y IndentChars controlan cómo se da formato al espacio en blanco que es poco importante. Por ejemplo, aplicar sangría a los nodos de elemento:


XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("books.xml", settings);


Utilice NewLineOnAttributes para escribir cada atributo en una nueva línea con un extensor nivel de sangría:


XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.NewLineOnAttributes = true;
XmlWriter writer = XmlWriter.Create("books.xml", settings);


Compatibilidad con los datos

Un sistema de escritura XML utiliza dos propiedades de la clase de XmlWriterSettings para comprobar la conformidad de los datos:

  • La propiedad de CheckCharacters indica al sistema de escritura XML a caracteres de comprobación y produce una excepción de XmlException si algunos caracteres están fuera del intervalo permitido, definidos por el W3C.

  • La propiedad de ConformanceLevel configura el sistema de escritura XML comprobar que la secuencia que escriben cumple las reglas de un documento XML correcto 1,0 o fragmento de documento, definidos por el W3C. Los tres niveles de conformidad se describen en la tabla siguiente. El valor predeterminado es Document. Para obtener información detallada, vea la propiedad de XmlWriterSettings.ConformanceLevel y la enumeración de System.Xml.ConformanceLevel .

    Nivel

    Descripción

    Document

    La salida XML cumple las reglas de un documento XML correcto 1,0 y puede ser procesada por cualquier procesador que cumple.

    Fragment

    La salida XML cumple las reglas de un fragmento de documento de XML 1,0 correcto.

    Auto

    El sistema de escritura XML determina que el nivel de conformación que comprobar para aplicar (documento o fragmento) según los datos entrantes.

Elementos de escritura

Puede utilizar los siguientes métodos de XmlWriter para escribir los nodos de elemento. Para obtener ejemplos, vea los métodos mostrados.

Utilice

Para

WriteElementString

Escriba un nodo de elemento completo, incluido el valor de cadena.

WriteStartElement

Para escribir un valor del elemento utilizando varias llamadas a métodos. Por ejemplo, puede llamar a WriteValue para escribir un valor con establecimiento de tipos, a WriteCharEntity para escribir una entidad de caracteres, a WriteAttributeString para escribir un atributo o puede escribir un elemento secundario. Ésta es una versión más compleja del método de WriteElementString .

Para cerrar el elemento, llame al método de WriteEndElement o de WriteFullEndElement .

WriteNode

Para copiar un nodo de elemento encontrado en la posición actual de un objeto de XmlReader o de XPathNavigator . Cuando se llama, copia todo del objeto de origen en la instancia de XmlWriter.

Atributos de escritura

Puede utilizar los siguientes métodos de XmlWriter para escribir atributos en los nodos de elemento. Estos métodos se pueden utilizar para crear declaraciones de espacio de nombres en un elemento, como se describe en la sección siguiente.

Utilice

Para

WriteAttributeString

Para escribir un nodo de atributo completo, incluido un valor de cadena.

WriteStartAttribute

Para escribir el valor de atributo utilizando varias llamadas a métodos. Por ejemplo, puede llamar a WriteValue para escribir un valor con tipo. Ésta es una versión más compleja del método de WriteElementString .

Para cerrar el elemento, llame al método de WriteEndAttribute .

WriteAttributes

Para copiar todos los atributos incluidos en la posición actual de un objeto de XmlReader . Los atributos se escriben que dependen del tipo de nodo que el lector actualmente en:

  • Para un nodo de atributo, escribe el atributo actual, y el resto de los atributos hasta la etiqueta de cierre del elemento.

  • Para un nodo de elemento, escribe todos los atributos contenidos en el elemento.

  • Para un nodo de la declaración XML, escribe todos los atributos de la declaración.

  • Para el resto de los tipos de nodo, el método produce una excepción.

Administrar espacios de nombres

Los espacios de nombres se utilizan para calificar nombres de atributos y elementos en un documento XML. Los prefijos de espacio de nombres asocian elementos y atributos con espacios de nombres, que a su vez se asocian a referencias de URI. Los espacios de nombres crean nombres de elementos y atributos únicos en un documento XML.

XmlWriter mantiene una pila de espacios de nombres que corresponde a todos los espacios de nombres definidos en el ámbito actual del espacio de nombres. A la hora de escribir elementos y atributos, puede utilizar espacios de nombres de las siguientes formas:

  • Declare los espacios de nombres manualmente con el método de WriteAttributeString . Esto puede resultar útil si conoce la mejor forma de optimizar el número de declaraciones de espacios de nombres. Si necesita un ejemplo, vea el método WriteAttributeString(String, String, String, String).

  • Invalidar la declaración de espacio de nombres actual con un espacio de nombres nuevo. En el código siguiente, el método de WriteAttributeString cambia el identificador URI de espacio de nombres para el prefijo de "x" de "123" a "abc".

    
    writer.WriteStartElement("x", "root", "123");
    writer.WriteStartElement("item");
    writer.WriteAttributeString("xmlns", "x", null, "abc");
    writer.WriteEndElement();
    writer.WriteEndElement();
    
    
    

    El código genera la siguiente cadena XML:

    <x:root xmlns:x="123">
      <item xmlns:x="abc" />
    </x:root>
    
  • Especifique un prefijo de espacio de nombres al escribir atributos o elementos. Muchos de los métodos utilizados para escribir el elemento y atributos permiten hacerlo. Por ejemplo, el método de WriteStartElement(String, String, String) escribe una etiqueta inicial y la asocia a un espacio de nombres y un prefijo especificados.

Escritura de datos con tipo

El método de WriteValue acepta un objeto de (CLR) de Common Language Runtime, convierte el valor de entrada en su representación de cadena de acuerdo con las reglas de conversión de tipo de datos del lenguaje de definición de esquemas XML (XSD), y escribe alejar usando el método de WriteString . Esto es más fácil de utilizar los métodos de la clase de XmlConvert para convertir los datos escritos en un valor de cadena antes de escribirlo.

Al escribir el texto, el valor con tipo se serializa en texto utilizando las reglas de XmlConvert para ese tipo de esquema.

Para los tipos de datos predeterminados XSD que corresponden a tipos CLR, vea el método de WriteValue .

XmlWriter también se puede utilizar para escribir en un almacén de datos XML. Por ejemplo, la clase XPathNavigator puede crear un objeto XmlWriter para crear nodos para un objeto XmlDocument. Si el almacén tiene información de esquema disponible, el método de WriteValue produce una excepción si intenta convertir un tipo no permitido. Si el almacén de datos no tiene información de esquema disponible, el método de WriteValue trata todos los valores como un tipo de xsd:anySimpleType .

Cerrando el sistema de escritura XML

Cuando se usan métodos de XmlWriter para generar XML, los elementos y atributos no se escriben hasta que se llame al método de Close . Por ejemplo, si utiliza XmlWriter para rellenar un objeto de XmlDocument , no podrá ver los elementos y atributos escritos en el documento de destino hasta que se cierra la instancia de XmlWriter .

Programación asincrónica

La mayoría de los métodos de XmlWriter tienen homólogos asincrónicos que tienen “Async” al final de sus nombres de método. Por ejemplo, el equivalente asincrónico de WriteAttributeString es WriteAttributeStringAsync.

Para el método de WriteValue , que no tiene un homólogo asincrónico, no sería el valor devuelto en una cadena y no utiliza el método de WriteStringAsync en su lugar.

Consideraciones de seguridad

Considere el siguiente al trabajar con la clase de XmlWriter :

  • Las excepciones producidas por XmlWriter pueden revelar información de ruta de acceso que no desea burbujeado hasta la aplicación. La aplicación debe detectarlas y procesarlas adecuadamente.

  • XmlWriter no valida ningún dato que se pasa al método de WriteDocType o de WriteRaw . No debe pasar datos arbitrarios a estos métodos.

El siguiente código de ejemplo muestra cómo utilizar el asincrónico API 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();
    }
}

.NET Framework

Compatible con: 4.5.2, 4.5.1, 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

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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.

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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft