XslCompiledTransform.Transform XslCompiledTransform.Transform XslCompiledTransform.Transform XslCompiledTransform.Transform Method

Definición

Ejecuta la transformación XSLT.Executes the XSLT transformation.

Sobrecargas

Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter)

Ejecuta la transformación usando el documento de entrada especificado mediante el objeto XmlReader y guarda el resultado en TextWriter.Executes the transform using the input document specified by the XmlReader object and outputs the results to a TextWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto IXPathNavigable y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an XmlWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto IXPathNavigable y guarda el resultado en un objeto TextWriter.Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an TextWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream)

Ejecuta la transformación usando el documento de entrada especificado mediante el objeto IXPathNavigable y guarda el resultado en una secuencia.Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to a stream. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional runtime arguments.

Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto XmlReader y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream)

Ejecuta la transformación usando el documento de entrada especificado mediante el objeto XmlReader y guarda el resultado en una secuencia.Executes the transform using the input document specified by the XmlReader object and outputs the results to a stream. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

Transform(String, String) Transform(String, String) Transform(String, String) Transform(String, String)

Ejecuta la transformación utilizando el documento de entrada especificado por el URI y envía el resultado a un archivo.Executes the transform using the input document specified by the URI and outputs the results to a file.

Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter)

Ejecuta la transformación usando el documento de entrada que especifica el URI y guarda el resultado en una clase TextWriter.Executes the transform using the input document specified by the URI and outputs the results to a TextWriter.

Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream)

Ejecuta la transformación utilizando el documento de entrada que especifica el URI y guarda el resultado en una secuencia.Executes the transform using the input document specified by the URI and outputs the results to stream. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto IXPathNavigable y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an XmlWriter.

Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto XmlReader y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter.

Transform(String, XmlWriter) Transform(String, XmlWriter) Transform(String, XmlWriter) Transform(String, XmlWriter)

Ejecuta la transformación usando el documento de entrada que especifica el URI y guarda el resultado en una clase XmlWriter.Executes the transform using the input document specified by the URI and outputs the results to an XmlWriter.

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

Ejecuta la transformación usando el documento de entrada especificado por el objeto XmlReader y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter. XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución y XmlResolver resuelve la función document() XSLT.The XsltArgumentList provides additional run-time arguments and the XmlResolver resolves the XSLT document() function.

Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter)

Ejecuta la transformación usando el documento de entrada que especifica el URI y guarda el resultado en una clase XmlWriter.Executes the transform using the input document specified by the URI and outputs the results to an XmlWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

Ejecuta la transformación usando el documento de entrada especificado por el objeto IXPathNavigable y guarda el resultado en XmlWriter.Executes the transform by using the input document that is specified by the IXPathNavigable object and outputs the results to an XmlWriter. El XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución y XmlResolver resuelve la función document() XSLT.The XsltArgumentList provides additional run-time arguments and the XmlResolver resolves the XSLT document() function.

Comentarios

Nota

Existen diferencias entre una transformación XSL compilada en modo de depuración y otra compilada en modo de lanzamiento.There are differences between XSLT compiled in Debug mode and XSLT compiled in Release mode. En algunas situaciones, las hojas de estilos compiladas en modo de depuración no producirán errores durante la Load, pero sí lo harán posteriormente durante la Transform.In some situations, style sheets compiled in Debug mode will not throw errors during Load, but will later fail during Transform. La misma hoja de estilos compilada en modo de lanzamiento producirá errores durante la Load.The same style sheet compiled in Release mode will fail during Load. Un ejemplo de este comportamiento se produce cuando una variable que no es de un tipo de conjunto de nodos se asigna a una expresión que requiere un conjunto de nodos.An example of such behavior is when a variable that is not of a node-set type is assigned to an expression where a node-set is required.

Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter)

Ejecuta la transformación usando el documento de entrada especificado mediante el objeto XmlReader y guarda el resultado en TextWriter.Executes the transform using the input document specified by the XmlReader object and outputs the results to a TextWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);
public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);
member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit
Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As TextWriter)

Parámetros

input
XmlReader XmlReader XmlReader XmlReader

XmlReader que contiene el documento de entrada.An XmlReader containing the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
TextWriter TextWriter TextWriter TextWriter

Objeto TextWriter al que se desea enviar el resultado.The TextWriter to which you want to output.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Comentarios

Si la hoja de estilos incluye una document() función XSLT, se resuelve con una XmlUrlResolver sin credenciales de usuario.If the style sheet includes an XSLT document() function, it is resolved using an XmlUrlResolver with no user credentials. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Consulte también:

Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto IXPathNavigable y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an XmlWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit
Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As XmlWriter)

Parámetros

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

Objeto que implementa la interfaz IXPathNavigable.An object implementing the IXPathNavigable interface. En Microsoft .NET Framework, puede ser una clase XmlNode (normalmente XmlDocument) o una clase XPathDocument que contiene los datos que se van a transformar.In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the data to be transformed.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
XmlWriter XmlWriter XmlWriter XmlWriter

Objeto XmlWriter al que se desea enviar el resultado.The XmlWriter to which you want to output.

Si la hoja de estilos contiene un elemento xsl:output, deberá crear la clase XmlWriter usando el objeto XmlWriterSettings devuelto por la propiedad OutputSettings.If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. Con ello se garantiza que XmlWriter tenga la configuración de resultados correcta.This ensures that the XmlWriter has the correct output settings.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Comentarios

Si la función document() XSLT está habilitada, se resuelve con una XmlUrlResolver sin credenciales de usuario.If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Este método no admite el xsl:strip-space elemento.This method does not support the xsl:strip-space element. Si la hoja de estilos compilada incluye el xsl:strip-space elemento, debe utilizar la Transform sobrecarga que XmlReader toma como argumento de entrada.If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

La interfaz IXPathNavigable se implementa en la clase XmlNode y XPathDocument.The IXPathNavigable interface is implemented in the XmlNode and XPathDocument classes. Estas clases representan una caché en memoria de datos XML.These classes represent an in-memory cache of XML data.

  • La clase XmlNode se basa en el Modelo de objetos de documento (DOM) del W3C e incluye capacidades de edición.The XmlNode class is based on the W3C Document Object Model (DOM) and includes editing capabilities.

  • La clase XPathDocument es un almacén de datos de solo lectura basado en el modelo de datos XPath.The XPathDocument class is a read-only data store based on the XPath data model. XPathDocument es la clase recomendada para el procesamiento XSLT.XPathDocument is the recommended class for XSLT processing. Proporciona un rendimiento mayor comparada con la clase XmlNode.It provides faster performance when compared to the XmlNode class.

Las transformaciones se aplican al documento en su totalidad.Transformations apply to the document as a whole. En otras palabras, si se pasa un nodo distinto del nodo raíz del documento, esto no evita que el proceso de transformación pueda obtener acceso a todos los nodos del documento cargado.In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. Para transformar un fragmento del nodo, debe crear un objeto que contenga solo el fragmento del nodo y pasar ese objeto al método Transform.To transform a node fragment, you must create an object containing just the node fragment, and pass that object to the Transform method. Para obtener más información, consulte Transformación de un fragmento del nodo.For more information, see How to: Transform a Node Fragment.

Consulte también:

Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto IXPathNavigable y guarda el resultado en un objeto TextWriter.Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an TextWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit
Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As TextWriter)

Parámetros

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

Objeto que implementa la interfaz IXPathNavigable.An object implementing the IXPathNavigable interface. En Microsoft .NET Framework, puede ser una clase XmlNode (normalmente XmlDocument) o una clase XPathDocument que contiene los datos que se van a transformar.In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the data to be transformed.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
TextWriter TextWriter TextWriter TextWriter

Objeto TextWriter al que se desea enviar el resultado.The TextWriter to which you want to output.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Comentarios

Si la función document() XSLT está habilitada, se resuelve con una XmlUrlResolver sin credenciales de usuario.If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Este método no admite el xsl:strip-space elemento.This method does not support the xsl:strip-space element. Si la hoja de estilos compilada incluye el xsl:strip-space elemento, debe utilizar la Transform sobrecarga que XmlReader toma como argumento de entrada.If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

La interfaz IXPathNavigable se implementa en la clase XmlNode y XPathDocument.The IXPathNavigable interface is implemented in the XmlNode and XPathDocument classes. Estas clases representan una caché en memoria de datos XML.These classes represent an in-memory cache of XML data.

  • La clase XmlNode se basa en el Modelo de objetos de documento (DOM) del W3C e incluye capacidades de edición.The XmlNode class is based on the W3C Document Object Model (DOM) and includes editing capabilities.

  • La clase XPathDocument es un almacén de datos de solo lectura basado en el modelo de datos XPath.The XPathDocument class is a read-only data store based on the XPath data model. XPathDocument es la clase recomendada para el procesamiento XSLT.XPathDocument is the recommended class for XSLT processing. Proporciona un rendimiento mayor comparada con la clase XmlNode.It provides faster performance when compared to the XmlNode class.

Las transformaciones se aplican al documento en su totalidad.Transformations apply to the document as a whole. En otras palabras, si se pasa un nodo distinto del nodo raíz del documento, esto no evita que el proceso de transformación pueda obtener acceso a todos los nodos del documento cargado.In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. Para transformar un fragmento del nodo, debe crear un objeto que contenga solo el fragmento del nodo y pasar ese objeto al método Transform.To transform a node fragment, you must create an object containing just the node fragment, and pass that object to the Transform method. Para obtener más información, consulte Transformación de un fragmento del nodo.For more information, see How to: Transform a Node Fragment.

Consulte también:

Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream)

Ejecuta la transformación usando el documento de entrada especificado mediante el objeto IXPathNavigable y guarda el resultado en una secuencia.Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to a stream. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional runtime arguments.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit
Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As Stream)

Parámetros

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

Objeto que implementa la interfaz IXPathNavigable.An object implementing the IXPathNavigable interface. En Microsoft .NET Framework, puede ser una clase XmlNode (normalmente XmlDocument) o una clase XPathDocument que contiene los datos que se van a transformar.In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the data to be transformed.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
Stream Stream Stream Stream

Secuencia a la que se desea enviar el resultado.The stream to which you want to output.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Ejemplos

En el ejemplo siguiente se ejecuta una transformación XSLT y se envían FileStreamlos resultados a.The following example executes an XSLT transformation and outputs to a FileStream.

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("output.xsl");

// Create the FileStream.
using (FileStream fs = new FileStream(@"c:\data\output.xml", FileMode.Create))
{
   // Execute the transformation.
   xslt.Transform(new XPathDocument("books.xml"), null, fs);
}
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the FileStream.
Using fs As New FileStream("c:\data\output.xml", FileMode.Create)
   ' Execute the transformation.
    xslt.Transform(New XPathDocument("books.xml"), Nothing, fs)
End Using

Comentarios

Si la función document() XSLT está habilitada, se resuelve con una XmlUrlResolver sin credenciales de usuario.If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Este método no admite el xsl:strip-space elemento.This method does not support the xsl:strip-space element. Si la hoja de estilos compilada incluye el xsl:strip-space elemento, debe utilizar la Transform sobrecarga que XmlReader toma como argumento de entrada.If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

La interfaz IXPathNavigable se implementa en la clase XmlNode y XPathDocument.The IXPathNavigable interface is implemented in the XmlNode and XPathDocument classes. Estas clases representan una caché en memoria de datos XML.These classes represent an in-memory cache of XML data.

  • La clase XmlNode se basa en el Modelo de objetos de documento (DOM) del W3C e incluye capacidades de edición.The XmlNode class is based on the W3C Document Object Model (DOM) and includes editing capabilities.

  • La clase XPathDocument es un almacén de datos de solo lectura basado en el modelo de datos XPath.The XPathDocument class is a read-only data store based on the XPath data model. XPathDocument es la clase recomendada para el procesamiento XSLT.XPathDocument is the recommended class for XSLT processing. Proporciona un rendimiento mayor comparada con la clase XmlNode.It provides faster performance when compared to the XmlNode class.

Las transformaciones se aplican al documento en su totalidad.Transformations apply to the document as a whole. En otras palabras, si se pasa un nodo distinto del nodo raíz del documento, esto no evita que el proceso de transformación pueda obtener acceso a todos los nodos del documento cargado.In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. Para transformar un fragmento del nodo, debe crear un objeto que contenga solo el fragmento del nodo y pasar ese objeto al método Transform.To transform a node fragment, you must create an object containing just the node fragment, and pass that object to the Transform method. Para obtener más información, consulte Transformación de un fragmento del nodo.For more information, see How to: Transform a Node Fragment.

Consulte también:

Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto XmlReader y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);
public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);
member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit
Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As XmlWriter)

Parámetros

input
XmlReader XmlReader XmlReader XmlReader

XmlReader que contiene el documento de entrada.An XmlReader containing the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
XmlWriter XmlWriter XmlWriter XmlWriter

Objeto XmlWriter al que se desea enviar el resultado.The XmlWriter to which you want to output.

Si la hoja de estilos contiene un elemento xsl:output, deberá crear la clase XmlWriter usando el objeto XmlWriterSettings devuelto por la propiedad OutputSettings.If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. Con ello se garantiza que XmlWriter tenga la configuración de resultados correcta.This ensures that the XmlWriter has the correct output settings.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Comentarios

Si la hoja de estilos incluye una document() función XSLT, se resuelve con una XmlUrlResolver sin credenciales de usuario.If the style sheet includes an XSLT document() function, it is resolved using an XmlUrlResolver with no user credentials. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Consulte también:

Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream)

Ejecuta la transformación usando el documento de entrada especificado mediante el objeto XmlReader y guarda el resultado en una secuencia.Executes the transform using the input document specified by the XmlReader object and outputs the results to a stream. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);
public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);
member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit
Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As Stream)

Parámetros

input
XmlReader XmlReader XmlReader XmlReader

XmlReader que contiene el documento de entrada.An XmlReader containing the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
Stream Stream Stream Stream

Secuencia a la que se desea enviar el resultado.The stream to which you want to output.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Comentarios

Si la hoja de estilos incluye una document() función XSLT, se resuelve con una XmlUrlResolver sin credenciales de usuario.If the style sheet includes an XSLT document() function, it is resolved using an XmlUrlResolver with no user credentials. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Consulte también:

Transform(String, String) Transform(String, String) Transform(String, String) Transform(String, String)

Ejecuta la transformación utilizando el documento de entrada especificado por el URI y envía el resultado a un archivo.Executes the transform using the input document specified by the URI and outputs the results to a file.

public:
 void Transform(System::String ^ inputUri, System::String ^ resultsFile);
public void Transform (string inputUri, string resultsFile);
member this.Transform : string * string -> unit
Public Sub Transform (inputUri As String, resultsFile As String)

Parámetros

inputUri
String String String String

URI del documento de entrada.The URI of the input document.

resultsFile
String String String String

URI del archivo de salida.The URI of the output file.

Excepciones

El valor de inputUri o resultsFile es null.The inputUri or resultsFile value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

No se puede encontrar el documento de entrada.The input document cannot be found.

El valor inputUri o resultsFile incluye un nombre de archivo o un directorio que no se puede encontrar.The inputUri or resultsFile value includes a filename or directory cannot be found.

El valor inputUri o resultsFile no se puede resolver.The inputUri or resultsFile value cannot be resolved.

O bien-or- Se ha producido un error al procesar la solicitud.An error occurred while processing the request

inputUri o resultsFile no es un URI válido.inputUri or resultsFile is not a valid URI.

Hubo un error de análisis al cargar el documento de entrada.There was a parsing error loading the input document.

Ejemplos

En el ejemplo siguiente se ejecuta una transformación y se envían los resultados a un archivo.The following example executes a transform and outputs to a file.

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("output.xsl");

// Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html");
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html")

En el ejemplo se usan los dos archivos de entrada siguientes:The sample uses the following two input files:

books.xml

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

output.xsl

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:template match="bookstore">
  <HTML>
    <BODY>
      <TABLE BORDER="2">
        <TR>
          <TD>ISBN</TD>
          <TD>Title</TD>
          <TD>Price</TD>
        </TR>
        <xsl:apply-templates select="book"/>
      </TABLE>
    </BODY>
  </HTML>
</xsl:template>
<xsl:template match="book">
  <TR>
    <TD><xsl:value-of select="@ISBN"/></TD>
    <TD><xsl:value-of select="title"/></TD>
    <TD><xsl:value-of select="price"/></TD>
  </TR>
</xsl:template>
</xsl:stylesheet>

Comentarios

Este método usa un valor XmlUrlResolver predeterminado sin credenciales de usuario para resolver los documentos de entrada y salida.This method uses a default XmlUrlResolver with no user credentials to resolve the input and output documents. Si alguno de estos recursos se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If any of these resources are located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Se XmlReader usa un con la configuración predeterminada para cargar el documento de entrada.An XmlReader with default settings is used to load the input document. El procesamiento de DTD está deshabilitado en el XmlReader.DTD processing is disabled on the XmlReader. Si requiere el Transform procesamiento de DTD, cree XmlReader un con esta característica habilitada y páselo al método.If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

Consulte también:

Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter)

Ejecuta la transformación usando el documento de entrada que especifica el URI y guarda el resultado en una clase TextWriter.Executes the transform using the input document specified by the URI and outputs the results to a TextWriter.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);
public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);
member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit
Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As TextWriter)

Parámetros

inputUri
String String String String

URI del documento de entrada.The URI of the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
TextWriter TextWriter TextWriter TextWriter

Objeto TextWriter al que se desea enviar el resultado.The TextWriter to which you want to output.

Excepciones

El valor de inputUri o results es null.The inputUri or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

El valor inputUri incluye un nombre de archivo o un directorio que no se puede encontrar.The inputUri value includes a filename or directory cannot be found.

El valor inputUri no se puede resolver.The inputUri value cannot be resolved.

o bien-or- Se ha producido un error al procesar la solicitud.An error occurred while processing the request

inputUri no es un URI válido.inputUri is not a valid URI.

Hubo un error de análisis al cargar el documento de entrada.There was a parsing error loading the input document.

Ejemplos

En el ejemplo siguiente se ejecuta una transformación XSLT y se genera una cadena.The following example executes an XSLT transformation and outputs a string.

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("HTML_out.xsl");

// Transform the file and output an HTML string.
string HTMLoutput;
StringWriter writer = new StringWriter();
xslt.Transform("books.xml", null, writer);
HTMLoutput = writer.ToString();
writer.Close();
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("HTML_out.xsl")
        
' Transform the file and output an HTML string.
Dim HTMLoutput As String
Dim writer As New StringWriter()
xslt.Transform("books.xml", Nothing, writer)
HTMLoutput = writer.ToString()
writer.Close()

Comentarios

Este método usa un valor XmlUrlResolver predeterminado sin credenciales de usuario para resolver el documento de entrada y las instancias document() de la función XSLT que se encuentran en la hoja de estilos.This method uses a default XmlUrlResolver with no user credentials to resolve the input document and any instances of the XSLT document() function found in the style sheet. Si alguno de estos recursos se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If any of these resources are located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Se XmlReader usa un con la configuración predeterminada para cargar el documento de entrada.An XmlReader with default settings is used to load the input document. El procesamiento de DTD está deshabilitado en el XmlReader.DTD processing is disabled on the XmlReader. Si requiere el Transform procesamiento de DTD, cree XmlReader un con esta característica habilitada y páselo al método.If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

Consulte también:

Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream)

Ejecuta la transformación utilizando el documento de entrada que especifica el URI y guarda el resultado en una secuencia.Executes the transform using the input document specified by the URI and outputs the results to stream. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);
public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);
member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit
Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As Stream)

Parámetros

inputUri
String String String String

URI del documento de entrada.The URI of the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
Stream Stream Stream Stream

Secuencia a la que se desea enviar el resultado.The stream to which you want to output.

Excepciones

El valor de inputUri o results es null.The inputUri or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

El valor inputUri incluye un nombre de archivo o un directorio que no se puede encontrar.The inputUri value includes a filename or directory cannot be found.

El valor inputUri no se puede resolver.The inputUri value cannot be resolved.

O bien-or- Se ha producido un error al procesar la solicitud.An error occurred while processing the request

inputUri no es un URI válido.inputUri is not a valid URI.

Hubo un error de análisis al cargar el documento de entrada.There was a parsing error loading the input document.

Comentarios

Este método usa un valor XmlUrlResolver predeterminado sin credenciales de usuario para resolver el documento de entrada y las instancias document() de la función XSLT que se encuentran en la hoja de estilos.This method uses a default XmlUrlResolver with no user credentials to resolve the input document and any instances of the XSLT document() function found in the style sheet. Si alguno de estos recursos se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If any of these resources are located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Se XmlReader usa un con la configuración predeterminada para cargar el documento de entrada.An XmlReader with default settings is used to load the input document. El procesamiento de DTD está deshabilitado en el XmlReader.DTD processing is disabled on the XmlReader. Si requiere el Transform procesamiento de DTD, cree XmlReader un con esta característica habilitada y páselo al método.If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

Consulte también:

Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto IXPathNavigable y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an XmlWriter.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::XmlWriter ^ results);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.XmlWriter results);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.XmlWriter -> unit
Public Sub Transform (input As IXPathNavigable, results As XmlWriter)

Parámetros

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

Objeto que implementa la interfaz IXPathNavigable.An object implementing the IXPathNavigable interface. En Microsoft .NET Framework, puede ser una clase XmlNode (normalmente XmlDocument) o una clase XPathDocument que contiene los datos que se van a transformar.In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the data to be transformed.

results
XmlWriter XmlWriter XmlWriter XmlWriter

Objeto XmlWriter al que se desea enviar el resultado.The XmlWriter to which you want to output.

Si la hoja de estilos contiene un elemento xsl:output, deberá crear la clase XmlWriter usando el objeto XmlWriterSettings devuelto por la propiedad OutputSettings.If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. Con ello se garantiza que XmlWriter tenga la configuración de resultados correcta.This ensures that the XmlWriter has the correct output settings.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Ejemplos

En el ejemplo siguiente se ejecuta una transformación XSLT y se envían XmlWriter los resultados a un objeto.The following example executes an XSLT transformation and outputs to an XmlWriter object.

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("output.xsl");

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

// Execute the transformation.
xslt.Transform(new XPathDocument("books.xml"), writer);
writer.Close();
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
' Execute the transformation.
xslt.Transform(New XPathDocument("books.xml"), writer)
writer.Close()

Comentarios

Si la función document() XSLT está habilitada, se resuelve con una XmlUrlResolver sin credenciales de usuario.If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Este método no admite el xsl:strip-space elemento.This method does not support the xsl:strip-space element. Si la hoja de estilos compilada incluye el xsl:strip-space elemento, debe utilizar la Transform sobrecarga que XmlReader toma como argumento de entrada.If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

La interfaz IXPathNavigable se implementa en la clase XmlNode y XPathDocument.The IXPathNavigable interface is implemented in the XmlNode and XPathDocument classes. Estas clases representan una caché en memoria de datos XML.These classes represent an in-memory cache of XML data.

  • La clase XmlNode se basa en el Modelo de objetos de documento (DOM) del W3C e incluye capacidades de edición.The XmlNode class is based on the W3C Document Object Model (DOM) and includes editing capabilities.

  • La clase XPathDocument es un almacén de datos de solo lectura basado en el modelo de datos XPath.The XPathDocument class is a read-only data store based on the XPath data model. XPathDocument es la clase recomendada para el procesamiento XSLT.XPathDocument is the recommended class for XSLT processing. Proporciona un rendimiento mayor comparada con la clase XmlNode.It provides faster performance when compared to the XmlNode class.

Las transformaciones se aplican al documento en su totalidad.Transformations apply to the document as a whole. En otras palabras, si se pasa un nodo distinto del nodo raíz del documento, esto no evita que el proceso de transformación pueda obtener acceso a todos los nodos del documento cargado.In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. Para transformar un fragmento del nodo, debe crear un objeto que contenga solo el fragmento del nodo y pasar ese objeto al método Transform.To transform a node fragment, you must create an object containing just the node fragment, and pass that object to the Transform method. Para obtener más información, consulte Transformación de un fragmento del nodo.For more information, see How to: Transform a Node Fragment.

Consulte también:

Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter)

Ejecuta la transformación usando el documento de entrada especificado por el objeto XmlReader y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::XmlWriter ^ results);
public void Transform (System.Xml.XmlReader input, System.Xml.XmlWriter results);
member this.Transform : System.Xml.XmlReader * System.Xml.XmlWriter -> unit
Public Sub Transform (input As XmlReader, results As XmlWriter)

Parámetros

input
XmlReader XmlReader XmlReader XmlReader

XmlReader que contiene el documento de entrada.The XmlReader containing the input document.

results
XmlWriter XmlWriter XmlWriter XmlWriter

Objeto XmlWriter al que se desea enviar el resultado.The XmlWriter to which you want to output.

Si la hoja de estilos contiene un elemento xsl:output, deberá crear la clase XmlWriter usando el objeto XmlWriterSettings devuelto por la propiedad OutputSettings.If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. Con ello se garantiza que XmlWriter tenga la configuración de resultados correcta.This ensures that the XmlWriter has the correct output settings.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Ejemplos

En el ejemplo siguiente se transforma el primer libro en el archivo Books. Xml.The following example transforms the first book in the books.xml file.

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("output.xsl");

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

XmlReader reader = XmlReader.Create("books.xml");
reader.MoveToContent();

// Execute the transformation.
xslt.Transform(reader, writer);
writer.Close();
reader.Close();
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
Dim reader As XmlReader = XmlReader.Create("books.xml")
reader.MoveToContent()
        
' Execute the transformation.
xslt.Transform(reader, writer)
writer.Close()
reader.Close()

Comentarios

Si la función document() XSLT está habilitada, se resuelve con una XmlUrlResolver sin credenciales de usuario.If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. Si el recurso externo se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Consulte también:

Transform(String, XmlWriter) Transform(String, XmlWriter) Transform(String, XmlWriter) Transform(String, XmlWriter)

Ejecuta la transformación usando el documento de entrada que especifica el URI y guarda el resultado en una clase XmlWriter.Executes the transform using the input document specified by the URI and outputs the results to an XmlWriter.

public:
 void Transform(System::String ^ inputUri, System::Xml::XmlWriter ^ results);
public void Transform (string inputUri, System.Xml.XmlWriter results);
member this.Transform : string * System.Xml.XmlWriter -> unit
Public Sub Transform (inputUri As String, results As XmlWriter)

Parámetros

inputUri
String String String String

URI del documento de entrada.The URI of the input document.

results
XmlWriter XmlWriter XmlWriter XmlWriter

Objeto XmlWriter al que se desea enviar el resultado.The XmlWriter to which you want to output.

Si la hoja de estilos contiene un elemento xsl:output, deberá crear la clase XmlWriter usando el objeto XmlWriterSettings devuelto por la propiedad OutputSettings.If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. Con ello se garantiza que XmlWriter tenga la configuración de resultados correcta.This ensures that the XmlWriter has the correct output settings.

Excepciones

El valor de inputUri o results es null.The inputUri or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

El valor inputUri incluye un nombre de archivo o un directorio que no se puede encontrar.The inputUri value includes a filename or directory cannot be found.

El valor inputUri no se puede resolver.The inputUri value cannot be resolved.

O bien-or- Error al procesar la solicitud.An error occurred while processing the request.

inputUri no es un URI válido.inputUri is not a valid URI.

Hubo un error de análisis al cargar el documento de entrada.There was a parsing error loading the input document.

Ejemplos

En el ejemplo siguiente se ejecuta una transformación XSLT y se envían XmlWriter los resultados a un objeto.The following example executes an XSLT transformation and outputs to an XmlWriter object.

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("output.xsl");

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

// Execute the transformation.
xslt.Transform("books.xml", writer);
writer.Close();
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
' Execute the transformation.
xslt.Transform("books.xml", writer)
writer.Close()

Comentarios

Este método usa un valor XmlUrlResolver predeterminado sin credenciales de usuario para resolver el documento de entrada y las instancias document() de la función XSLT que se encuentran en la hoja de estilos.This method uses a default XmlUrlResolver with no user credentials to resolve the input document and any instances of the XSLT document() function found in the style sheet. Si alguno de estos recursos se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If any of these resources are located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Se XmlReader usa un con la configuración predeterminada para cargar el documento de entrada.An XmlReader with default settings is used to load the input document. El procesamiento de DTD está deshabilitado en el XmlReader.DTD processing is disabled on the XmlReader. Si requiere el Transform procesamiento de DTD, cree XmlReader un con esta característica habilitada y páselo al método.If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

Este método no admite el xsl:strip-space elemento.This method does not support the xsl:strip-space element. Si la hoja de estilos compilada incluye el xsl:strip-space elemento, debe utilizar la Transform sobrecarga que XmlReader toma como argumento de entrada.If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

Consulte también:

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

Ejecuta la transformación usando el documento de entrada especificado por el objeto XmlReader y guarda el resultado en un objeto XmlWriter.Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter. XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución y XmlResolver resuelve la función document() XSLT.The XsltArgumentList provides additional run-time arguments and the XmlResolver resolves the XSLT document() function.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results, System::Xml::XmlResolver ^ documentResolver);
public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver documentResolver);
member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter * System.Xml.XmlResolver -> unit
Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As XmlWriter, documentResolver As XmlResolver)

Parámetros

input
XmlReader XmlReader XmlReader XmlReader

XmlReader que contiene el documento de entrada.An XmlReader containing the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
XmlWriter XmlWriter XmlWriter XmlWriter

Objeto XmlWriter al que se desea enviar el resultado.The XmlWriter to which you want to output.

Si la hoja de estilos contiene un elemento xsl:output, deberá crear la clase XmlWriter usando el objeto XmlWriterSettings devuelto por la propiedad OutputSettings.If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. Con ello se garantiza que XmlWriter tenga la configuración de resultados correcta.This ensures that the XmlWriter has the correct output settings.

documentResolver
XmlResolver XmlResolver XmlResolver XmlResolver

XmlResolver que se usa para resolver la función document() de XSLT.The XmlResolver used to resolve the XSLT document() function. Si es null, la función document() no se resuelve.If this is null, the document() function is not resolved.

Excepciones

El valor de input o results es null.The input or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

Ejemplos

XmlSecureResolver En el ejemplo siguiente se utiliza para resolver la document() función XSLT.The following example uses an XmlSecureResolver to resolve the XSLT document() function.

// Create a resolver and specify the necessary credentials.
XmlSecureResolver resolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
System.Net.NetworkCredential myCred;
myCred  = new System.Net.NetworkCredential(UserName,SecurelyStoredPassword,Domain);  
resolver.Credentials = myCred;

XsltSettings settings = new XsltSettings();
settings.EnableDocumentFunction = true;
  
// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("http://serverName/data/xsl/sort.xsl", settings, resolver);

// Transform the file.
using (XmlReader reader = XmlReader.Create("books.xml"))
{
   using (XmlWriter writer = XmlWriter.Create("output.xml")) 
   {
      xslt.Transform(reader, null, writer, resolver);
   }
}
' Create a resolver and specify the necessary credentials.
Dim resolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword, Domain)
resolver.Credentials = myCred
        
Dim settings As New XsltSettings()
settings.EnableDocumentFunction = True
        
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("http://serverName/data/xsl/sort.xsl", settings, resolver)
        
' Transform the file.
        Using reader As XmlReader = XmlReader.Create("books.xml")

            Using writer As XmlWriter = XmlWriter.Create("output.xml")
                xslt.Transform(reader, Nothing, writer, resolver)
            End Using

        End Using
Consulte también:

Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter)

Ejecuta la transformación usando el documento de entrada que especifica el URI y guarda el resultado en una clase XmlWriter.Executes the transform using the input document specified by the URI and outputs the results to an XmlWriter. La clase XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución.The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);
public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);
member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit
Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As XmlWriter)

Parámetros

inputUri
String String String String

URI del documento de entrada.The URI of the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

XsltArgumentList que contiene los argumentos, calificados con el espacio de nombres, utilizados como entrada para la transformación.An XsltArgumentList containing the namespace-qualified arguments used as input to the transform. Este valor puede ser null.This value can be null.

results
XmlWriter XmlWriter XmlWriter XmlWriter

Objeto XmlWriter al que se desea enviar el resultado.The XmlWriter to which you want to output.

Si la hoja de estilos contiene un elemento xsl:output, deberá crear la clase XmlWriter usando el objeto XmlWriterSettings devuelto por la propiedad OutputSettings.If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. Con ello se garantiza que XmlWriter tenga la configuración de resultados correcta.This ensures that the XmlWriter has the correct output settings.

Excepciones

El valor de inputUri o results es null.The inputUri or results value is null.

Se ha producido un error al ejecutar la transformación XSLT.There was an error executing the XSLT transform.

El valor inputtUri incluye un nombre de archivo o un directorio que no se puede encontrar.The inputtUri value includes a filename or directory cannot be found.

El valor inputUri no se puede resolver.The inputUri value cannot be resolved.

o bien-or- Error al procesar la solicitud.An error occurred while processing the request.

inputUri no es un URI válido.inputUri is not a valid URI.

Hubo un error de análisis al cargar el documento de entrada.There was a parsing error loading the input document.

Ejemplos

En el ejemplo siguiente se XsltArgumentList usa un objeto para crear un parámetro que representa la fecha y hora actuales.The following example uses an XsltArgumentList object to create a parameter representing the current date and time.

using System;
using System.IO;
using System.Xml;
using System.Xml.Xsl;

public class Sample
{

    public static void Main()
    {

        // Create the XslCompiledTransform and load the stylesheet.
        XslCompiledTransform xslt = new XslCompiledTransform();
        xslt.Load("order.xsl");

        // Create the XsltArgumentList.
        XsltArgumentList xslArg = new XsltArgumentList();

        // Create a parameter which represents the current date and time.
        DateTime d = DateTime.Now;
        xslArg.AddParam("date", "", d.ToString());

        // Transform the file.
        using (XmlWriter w = XmlWriter.Create("output.xml"))
        {
            xslt.Transform("order.xml", xslArg, w);
        }
    }
}
Imports System.IO
Imports System.Xml
Imports System.Xml.Xsl

Public Class Sample

    Public Shared Sub Main()

        ' Create the XslCompiledTransform and load the stylesheet.
        Dim xslt As New XslCompiledTransform()
        xslt.Load("order.xsl")

        ' Create the XsltArgumentList.
        Dim xslArg As New XsltArgumentList()

        ' Create a parameter which represents the current date and time.
        Dim d As DateTime = DateTime.Now
        xslArg.AddParam("date", "", d.ToString())

        Using w As XmlWriter = XmlWriter.Create("output.xml")
            ' Transform the file.
            xslt.Transform("order.xml", xslArg, w)
        End Using

    End Sub
End Class 'Sample

En el ejemplo se usan los dos archivos de datos siguientes como entrada.The example uses the following two data files as input.

order.xmlorder.xml

<!--Represents a customer order-->
<order>
  <book ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <cd ISBN='2-3631-4'>
    <title>Americana</title>
    <price>16.95</price>
  </cd>
</order>

order.xslorder.xsl

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:param name="date"/>
  <xsl:template match="/">
    <order>
      <date><xsl:value-of select="$date"/></date>
      <total><xsl:value-of select="sum(//price)"/></total>
    </order>
  </xsl:template>
</xsl:stylesheet>

Comentarios

Este método usa un valor XmlUrlResolver predeterminado sin credenciales de usuario para resolver el documento de entrada y las instancias document() de la función XSLT que se encuentran en la hoja de estilos.This method uses a default XmlUrlResolver with no user credentials to resolve the input document and any instances of the XSLT document() function found in the style sheet. Si alguno de estos recursos se encuentra en un recurso de red que requiere autenticación, use la sobrecarga que toma XmlResolver como uno de sus argumentos y especifique un XmlResolver con las credenciales necesarias.If any of these resources are located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

Se XmlReader usa un con la configuración predeterminada para cargar el documento de entrada.An XmlReader with default settings is used to load the input document. El procesamiento de DTD está deshabilitado en el XmlReader.DTD processing is disabled on the XmlReader. Si requiere el Transform procesamiento de DTD, cree XmlReader un con esta característica habilitada y páselo al método.If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

Consulte también:

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

Ejecuta la transformación usando el documento de entrada especificado por el objeto IXPathNavigable y guarda el resultado en XmlWriter.Executes the transform by using the input document that is specified by the IXPathNavigable object and outputs the results to an XmlWriter. El XsltArgumentList proporciona argumentos adicionales en tiempo de ejecución y XmlResolver resuelve la función document() XSLT.The XsltArgumentList provides additional run-time arguments and the XmlResolver resolves the XSLT document() function.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results, System::Xml::XmlResolver ^ documentResolver);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver documentResolver);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter * System.Xml.XmlResolver -> unit
Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As XmlWriter, documentResolver As XmlResolver)

Parámetros

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

El documento que se va a transformar lo especifica el objeto IXPathNavigable.The document to transform that is specified by the IXPathNavigable object.

results
XmlWriter XmlWriter XmlWriter XmlWriter

Objeto XmlWriter al que se desea enviar el resultado.The XmlWriter to which you want to output.

Si la hoja de estilos contiene un elemento xsl:output, deberá crear la clase XmlWriter usando el objeto XmlWriterSettings que devuelve la propiedad OutputSettings.If the style sheet contains an xsl:output element, you should create the XmlWriter by using the XmlWriterSettings object that is returned from the OutputSettings property. Con ello se garantiza que XmlWriter tenga la configuración de resultados correcta.This ensures that the XmlWriter has the correct output settings.

documentResolver
XmlResolver XmlResolver XmlResolver XmlResolver

XmlResolver que se usa para resolver la función document() de XSLT.The XmlResolver used to resolve the XSLT document() function. Si es null, la función document() no se resuelve.If this is null, the document() function is not resolved.

Se aplica a