Opciones de salida en la clase XslCompiledTransform
Actualización: November 2007
En este tema se describen las opciones de salida XSLT disponibles. Puede especificar opciones de salida en la hoja de estilos o en el método Transform.
Elemento xsl:output
El elemento xsl:output especifica opciones para la salida. El tipo de salida que especifica el método Transform determina el comportamiento de las opciones xsl:output.
En la siguiente tabla se describe el comportamiento de cada uno de los atributos disponibles en el elemento xsl:output cuando el tipo de salida es una secuencia o un TextWriter.
Nombre de atributo |
Comportamiento |
|---|---|
method |
Compatible. |
version |
Se omite. La versión es siempre 1.0 para XML y 4.0 para HTML. |
encoding |
Se omite cuando la salida se envía a TextWriter. Se utiliza en su lugar la propiedad TextWriter.Encoding. |
omit-xml-declaration |
Compatible. |
standalone |
Compatible. |
doctype-public |
Compatible. |
doctype-system |
Compatible. |
cdata-section-elements |
Compatible. |
indent |
Compatible. |
media-type |
Compatible. |
Envío de la salida a XmlWriter
Si la hoja de estilos utiliza el elemento xsl:output y el tipo de salida es un objeto XmlWriter, debería utilizar la propiedad XslCompiledTransform.OutputSettings cuando cree el objeto XmlWriter. La propiedad XslCompiledTransform.OutputSettings devuelve un objeto XmlWriterSettings que contiene información derivada del elemento xsl:output de una hoja de estilos compilada. Este objeto XmlWriterSettings se puede pasar al método XmlWriter.Create para crear un objeto XmlWriter con los valores correctos.
Tipos de salida
En la siguiente lista se describen los tipos de salida disponibles en el comando Transform.
XmlWriter
La clase XmlWriter escribe archivos o secuencias XML. Puede especificar las características que se van a permitir en el objeto XmlWriter, incluyendo las opciones de salida, utilizando la clase XmlWriterSettings. La clase XmlWriter es una parte integral de la estructura System.Xml. Utilice este tipo de salida para canalizar los resultados de la salida en otro proceso XML.
Cadena
Utilice este tipo de salida para especificar el identificador URI del archivo de salida.
Secuencia
Una secuencia es una abstracción de una secuencia de bytes como, por ejemplo, un archivo, un dispositivo de entrada/salida, una canalización de comunicación entre procesos o un socket TCP/IP. La clase Stream y sus clases derivadas proporcionan una vista genérica de estos diferentes tipos de entrada y salida, aislando al programador de los detalles específicos del sistema operativo y los dispositivos subyacentes.
Utilice este tipo de salida para enviar datos a una FileStream, MemoryStream o a una secuencia de salida (Response.OutputStream).
TextWriter
TextWriter escribe caracteres secuenciales. Se implementa en las clases StringWriter y StreamWriter, que escriben caracteres en cadenas o secuencias, respectivamente. Utilice este tipo de salida cuando desee enviar la salida a una cadena.
Notas
- Cuando escriba etiquetas vacías, se escribe un espacio entre el último carácter del nombre del elemento y la barra diagonal inversa, por ejemplo, <myElement />.Esto permite que los exploradores más antiguos muestren correctamente las páginas HTML generadas.