XslCompiledTransform.Load Método

Definición

Espacio de nombres:

System.Xml.Xsl

Ensamblado:

System.Xml.ReaderWriter.dll

Compila la hoja de estilos.

Sobrecargas

Load(IXPathNavigable, XsltSettings, XmlResolver)	Compila la hoja de estilos XSLT incluida en IXPathNavigable. XmlResolver resuelve cualquier XSLT import o include elemento y la configuración de XSLT determinan los permisos para la hoja de estilos.
Load(String, XsltSettings, XmlResolver)	Carga y compila la hoja de estilos XSLT que especifica el URI. XmlResolver resuelve cualquier XSLT import o include elemento y la configuración de XSLT determinan los permisos para la hoja de estilos.
Load(MethodInfo, Byte[], Type[])	Carga un método de una hoja de estilos compilada con la utilidad XSLTC.exe.
Load(XmlReader, XsltSettings, XmlResolver)	Compila la hoja de estilos XSLT incluida en XmlReader. XmlResolver resuelve cualquier XSLT import o include elemento y la configuración de XSLT determinan los permisos para la hoja de estilos.
Load(XmlReader)	Compila la hoja de estilos incluida en XmlReader.
Load(Type)	Carga la hoja de estilos compilada que se creó usando el compilador XSLT (xsltc.exe).
Load(String)	Carga y compila la hoja de estilos situada en el URI especificado.
Load(IXPathNavigable)	Compila la hoja de estilos incluida en el objeto IXPathNavigable.

Comentarios

Aunque el rendimiento total de la clase XslCompiledTransform es mejor que la clase XslTransform, el método Load de la clase XslCompiledTransform podría ser más lento que el método Load de la clase XslTransform cuando se le llama por primera vez para una transformación. Esto se debe a que el archivo XSLT debe compilarse antes de cargarse. Para más información, vea la entrada de blog siguiente: XslCompiledTransform Slower than XslTransform? (¿Es más lento XslCompiledTransform que XslTransform?)

Nota

Existen diferencias entre una transformación XSL compilada en modo de depuración y otra compilada en modo de lanzamiento. 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. La misma hoja de estilos compilada en modo de lanzamiento producirá errores durante la 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.

Load(IXPathNavigable, XsltSettings, XmlResolver)

Source:

XslCompiledTransform.cs

Compila la hoja de estilos XSLT incluida en IXPathNavigable. XmlResolver resuelve cualquier XSLT import o include elemento y la configuración de XSLT determinan los permisos para la hoja de estilos.

public:
 void Load(System::Xml::XPath::IXPathNavigable ^ stylesheet, System::Xml::Xsl::XsltSettings ^ settings, System::Xml::XmlResolver ^ stylesheetResolver);

public void Load (System.Xml.XPath.IXPathNavigable stylesheet, System.Xml.Xsl.XsltSettings? settings, System.Xml.XmlResolver? stylesheetResolver);

member this.Load : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltSettings * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheet As IXPathNavigable, settings As XsltSettings, stylesheetResolver As XmlResolver)

Parámetros

stylesheet

IXPathNavigable

Un objeto que implementa la interfaz IXPathNavigable. En Microsoft .NET Framework, puede ser una clase XmlNode (normalmente una clase XmlDocument) o una clase XPathDocument que contiene la hoja de estilos.

settings

XsltSettings

XsltSettings que se va a aplicar a la hoja de estilos. Si el valor es null, se aplica la configuración Default.

stylesheetResolver

XmlResolver

utilizado XmlResolver para resolver las hojas de estilos a las que se hace referencia en XSLT import y include elementos. Si es null, los recursos externos no se resuelven.

Excepciones

ArgumentNullException

El valor de stylesheet es null.

XsltException

La hoja de estilos contiene un error.

Ejemplos

En el ejemplo siguiente se carga una hoja de estilos. El XmlSecureResolver objeto contiene las credenciales necesarias para tener acceso a los import elementos o include que se encuentran en la hoja de estilos.

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

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

' Create a resolver and specify the necessary credentials.
Dim resolver As New XmlUrlResolver()
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword, Domain)
resolver.Credentials = myCred
        
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load(New XPathDocument("http://serverName/data/xsl/sort.xsl"), XsltSettings.Default, resolver)

Comentarios

La XslCompiledTransform clase admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe usar el http://www.w3.org/1999/XSL/Transform espacio de nombres .

Consulte también

• Uso de la clase XslCompiledTransform

Load(String, XsltSettings, XmlResolver)

Source:

XslCompiledTransform.cs

Carga y compila la hoja de estilos XSLT que especifica el URI. XmlResolver resuelve cualquier XSLT import o include elemento y la configuración de XSLT determinan los permisos para la hoja de estilos.

public:
 void Load(System::String ^ stylesheetUri, System::Xml::Xsl::XsltSettings ^ settings, System::Xml::XmlResolver ^ stylesheetResolver);

public void Load (string stylesheetUri, System.Xml.Xsl.XsltSettings? settings, System.Xml.XmlResolver? stylesheetResolver);

member this.Load : string * System.Xml.Xsl.XsltSettings * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheetUri As String, settings As XsltSettings, stylesheetResolver As XmlResolver)

Parámetros

stylesheetUri

String

URI de la hoja de estilos.

settings

XsltSettings

XsltSettings que se va a aplicar a la hoja de estilos. Si el valor es null, se aplica la configuración Default.

stylesheetResolver

XmlResolver

XmlResolver utilizado para resolver el URI de la hoja de estilos y las hojas de estilos a las que se hace referencia en XSLT import y include elementos.

Excepciones

ArgumentNullException

El valor de stylesheetUri o stylesheetResolver es null.

XsltException

La hoja de estilos contiene un error.

FileNotFoundException

No se puede encontrar la hoja de estilos.

DirectoryNotFoundException

El valor stylesheetUri incluye un nombre de archivo o un directorio que no se puede encontrar.

WebException

El valor stylesheetUri no se puede resolver.

o bien

Se produjo un error al procesar la solicitud.

UriFormatException

stylesheetUri no es un URI válido.

XmlException

Hubo un error de análisis al cargar la hoja de estilos.

Ejemplos

En el ejemplo siguiente se carga una hoja de estilos que se almacena en un recurso de red. Un objeto XmlSecureResolver especifica las credenciales necesarias para tener acceso a la hoja de estilos.

// Create the XslCompiledTransform object.
XslCompiledTransform xslt = new XslCompiledTransform();

// Create a resolver and set the credentials to use.
XmlSecureResolver resolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
resolver.Credentials = CredentialCache.DefaultCredentials;

// Load the style sheet.
xslt.Load("http://serverName/data/xsl/sort.xsl", null, resolver);

' Create the XslCompiledTransform object.
Dim xslt As New XslCompiledTransform()
        
' Create a resolver and set the credentials to use.
Dim resolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
resolver.Credentials = CredentialCache.DefaultCredentials
        
' Load the style sheet.
xslt.Load("http://serverName/data/xsl/sort.xsl", Nothing, resolver)

Comentarios

La XslCompiledTransform clase admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe usar el http://www.w3.org/1999/XSL/Transform espacio de nombres .

Con XmlReader la configuración predeterminada se usa para cargar la hoja de estilos. El procesamiento de DTD está deshabilitado en .XmlReader Si necesita el procesamiento de DTD, cree un XmlReader con esta característica habilitada y páselo al Load método .

Consulte también

• Uso de la clase XslCompiledTransform

Load(MethodInfo, Byte[], Type[])

Source:

XslCompiledTransform.cs

Carga un método de una hoja de estilos compilada con la utilidad XSLTC.exe.

public:
 void Load(System::Reflection::MethodInfo ^ executeMethod, cli::array <System::Byte> ^ queryData, cli::array <Type ^> ^ earlyBoundTypes);

public void Load (System.Reflection.MethodInfo executeMethod, byte[] queryData, Type[]? earlyBoundTypes);

member this.Load : System.Reflection.MethodInfo * byte[] * Type[] -> unit

Public Sub Load (executeMethod As MethodInfo, queryData As Byte(), earlyBoundTypes As Type())

Parámetros

executeMethod

MethodInfo

Objeto MethodInfo que representa el método generado por execute el compilador de la hoja de estilos compilada.

queryData

Byte[]

Matriz de bytes de estructuras de datos serializadas en el staticData campo de la hoja de estilos compilada según lo generado por el CompileToType(XmlReader, XsltSettings, XmlResolver, Boolean, TypeBuilder, String) método .

earlyBoundTypes

Type[]

Matriz de tipos almacenados en el campo generado ebTypes por el compilador de la hoja de estilos compilada.

Ejemplos

En el Load ejemplo de código siguiente se usa para cargar una hoja de estilos compilada. La transformación reduce el valor del Price elemento en un diez por ciento.

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

class Example
{
    static void Main()
    {
        // Load a stylesheet compiled using the XSLTC.EXE utility
        Type compiledStylesheet = Assembly.Load("Transform").GetType("Transform");

        // Extract private members from the compiled stylesheet
        BindingFlags bindingFlags = BindingFlags.NonPublic | BindingFlags.Static;
        MethodInfo executeMethod = compiledStylesheet.GetMethod("Execute", bindingFlags);
        object staticData = compiledStylesheet.GetField("staticData", bindingFlags).GetValue(null);
        object earlyBoundTypes = compiledStylesheet.GetField("ebTypes", bindingFlags).GetValue(null);

        // Load into XslCompiledTransform
        XslCompiledTransform xslt = new XslCompiledTransform();
        xslt.Load(executeMethod, (byte[])staticData, (Type[])earlyBoundTypes);

        // Run the transformation
        xslt.Transform(XmlReader.Create(new StringReader("<Root><Price>9.50</Price></Root>")), (XsltArgumentList)null, Console.Out);
    }
}

Imports System.IO
Imports System.Reflection
Imports System.Xml
Imports System.Xml.Xsl

Module Module1

    Sub Main()
        ' Load a stylesheet compiled using the XSLTC.EXE utility
        Dim compiledStylesheet As Type = [Assembly].Load("Transform").GetType("Transform")

        ' Extract private members from the compiled stylesheet
        Dim bindingFlags As BindingFlags = bindingFlags.NonPublic Or bindingFlags.Static
        Dim executeMethod As MethodInfo = compiledStylesheet.GetMethod("Execute", bindingFlags)
        Dim staticData As Object = compiledStylesheet.GetField("staticData", bindingFlags).GetValue(Nothing)
        Dim earlyBoundTypes As Object = compiledStylesheet.GetField("ebTypes", bindingFlags).GetValue(Nothing)

        ' Load into XslCompiledTransform
        Dim xslt As New XslCompiledTransform()
        xslt.Load(executeMethod, CType(staticData, Byte()), CType(earlyBoundTypes, Type()))

        ' Run the transformation
        xslt.Transform(XmlReader.Create(New StringReader("<Root><Price>9.50</Price></Root>")), CType(Nothing, XsltArgumentList), Console.Out)
    End Sub
End Module

Nota

El ensamblado "Transform" usado en este ejemplo se creó con la utilidad xsltc.exe. Para obtener información detallada sobre el uso de esta herramienta de línea de comandos, vea How to: Perform an XSLT Transformation by Using an Assembly.

En el ejemplo de código anterior se usa la siguiente transformación:

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:msxsl="urn:schemas-microsoft-com:xslt"
  xmlns:user="urn:my-scripts">
  <msxsl:script language="C#" implements-prefix="user">
    <![CDATA[
  public double modifyPrice(double price){
    price*=0.9;
    return price;
  }
  ]]>
  </msxsl:script>
  <xsl:template match="Root">
    <Root xmlns="">
      <Price><xsl:value-of select="user:modifyPrice(Price)"/></Price>
    </Root>
  </xsl:template>
</xsl:stylesheet>

Comentarios

Este método acepta una hoja de estilos compilada en forma de objeto MethodInfo , una matriz de bytes y una matriz de tipos. DynamicMethod Los objetos se pueden usar para permitir que los métodos de hoja de estilos compilados se descarten cuando se reclama el XslCompiledTransform objeto.

Load(XmlReader, XsltSettings, XmlResolver)

Source:

XslCompiledTransform.cs

Compila la hoja de estilos XSLT incluida en XmlReader. XmlResolver resuelve cualquier XSLT import o include elemento y la configuración de XSLT determinan los permisos para la hoja de estilos.

public:
 void Load(System::Xml::XmlReader ^ stylesheet, System::Xml::Xsl::XsltSettings ^ settings, System::Xml::XmlResolver ^ stylesheetResolver);

public void Load (System.Xml.XmlReader stylesheet, System.Xml.Xsl.XsltSettings? settings, System.Xml.XmlResolver? stylesheetResolver);

member this.Load : System.Xml.XmlReader * System.Xml.Xsl.XsltSettings * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheet As XmlReader, settings As XsltSettings, stylesheetResolver As XmlResolver)

Parámetros

stylesheet

XmlReader

XmlReader que contiene la hoja de estilos.

settings

XsltSettings

XsltSettings que se va a aplicar a la hoja de estilos. Si el valor es null, se aplica la configuración Default.

stylesheetResolver

XmlResolver

utilizado XmlResolver para resolver las hojas de estilos a las que se hace referencia en XSLT import y include elementos. Si es null, los recursos externos no se resuelven.

Excepciones

ArgumentNullException

El valor de stylesheet es null.

XsltException

La hoja de estilos contiene un error.

Ejemplos

En el ejemplo siguiente se carga una hoja de estilos y se habilita la compatibilidad con el scripting XSLT.

// Create the XslCompiledTransform object.
XslCompiledTransform xslt = new XslCompiledTransform();

// Create a resolver and set the credentials to use.
XmlSecureResolver resolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
resolver.Credentials = CredentialCache.DefaultCredentials;

XmlReader reader = XmlReader.Create("http://serverName/data/xsl/sort.xsl");

// Create the XsltSettings object with script enabled.
XsltSettings settings = new XsltSettings(false,true);

// Load the style sheet.
xslt.Load(reader, settings, resolver);

' Create the XslCompiledTransform object.
Dim xslt As New XslCompiledTransform()
        
' Create a resolver and set the credentials to use.
Dim resolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
resolver.Credentials = CredentialCache.DefaultCredentials
        
Dim reader As XmlReader = XmlReader.Create("http://serverName/data/xsl/sort.xsl")
        
' Create the XsltSettings object with script enabled.
Dim settings As New XsltSettings(False, True)
        
' Load the style sheet.
xslt.Load(reader, settings, resolver)

Comentarios

La XslCompiledTransform clase admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe usar el http://www.w3.org/1999/XSL/Transform espacio de nombres .

La hoja de estilos se carga desde el nodo actual de a través de XmlReader todos sus elementos secundarios. Esto le permite usar una parte de un documento como hoja de estilos. Una vez completado el Load método, el XmlReader se coloca en el siguiente nodo después del final de la hoja de estilos. Si se llega al final del documento, XmlReader se sitúa al final del archivo.

Consulte también

• Uso de la clase XslCompiledTransform

Load(XmlReader)

Source:

XslCompiledTransform.cs

Compila la hoja de estilos incluida en XmlReader.

public:
 void Load(System::Xml::XmlReader ^ stylesheet);

public void Load (System.Xml.XmlReader stylesheet);

member this.Load : System.Xml.XmlReader -> unit

Public Sub Load (stylesheet As XmlReader)

Parámetros

stylesheet

XmlReader

XmlReader que contiene la hoja de estilos.

Excepciones

ArgumentNullException

El valor de stylesheet es null.

XsltException

La hoja de estilos contiene un error.

Ejemplos

En el ejemplo siguiente se carga una hoja de estilos contenida en un XmlReader objeto .

// Create a reader that contains the style sheet.
XmlReader reader = XmlReader.Create("titles.xsl");
reader.ReadToDescendant("xsl:stylesheet");

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load(reader);

' Create a reader that contains the style sheet.
Dim reader As XmlReader = XmlReader.Create("titles.xsl")
reader.ReadToDescendant("xsl:stylesheet")
        
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load(reader)

Comentarios

La XslCompiledTransform clase admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe usar el http://www.w3.org/1999/XSL/Transform espacio de nombres .

La hoja de estilos se carga desde el nodo actual de a través de XmlReader todos sus elementos secundarios. Esto le permite usar una parte de un documento como hoja de estilos. Una vez completado el Load método, el XmlReader se coloca en el siguiente nodo después del final de la hoja de estilos. Si se llega al final del documento, XmlReader se sitúa al final del archivo.

Este método tiene el siguiente comportamiento:

• Sin XmlUrlResolver credenciales de usuario se usa para procesar elementos xsl:import o xsl:include .

• La document() función está deshabilitada.

• No se admiten scripts incrustados.

Puede usar la Load(XmlReader, XsltSettings, XmlResolver) sobrecarga para especificar un XmlResolver objeto con las credenciales de autenticación necesarias o para especificar una configuración XSLT diferente.

Consulte también

• Uso de la clase XslCompiledTransform

Load(Type)

Source:

XslCompiledTransform.cs

Carga la hoja de estilos compilada que se creó usando el compilador XSLT (xsltc.exe).

public:
 void Load(Type ^ compiledStylesheet);

public void Load (Type compiledStylesheet);

member this.Load : Type -> unit

Public Sub Load (compiledStylesheet As Type)

Parámetros

compiledStylesheet

Type

Nombre de la clase que contiene la hoja de estilos compilada.

Normalmente se trata del nombre de la hoja de estilos. A menos que se especifique lo contrario, la herramienta xsltc.exe usa el nombre de la hoja de estilos para los nombres de ensamblado y clase.

Ejemplos

En el ejemplo siguiente se muestra cómo cargar una hoja de estilos compilada desde un ensamblado XSLT. En el ejemplo se supone que la herramienta xsltc.exe se usó para crear un ensamblado denominado bookOrders.dll con una clase denominada bookOrders.

Nota

Debe hacer referencia al ensamblado XSLT al compilar el código. Por ejemplo, csc /r:system.dll;system.xml.dll;bookOrders.dll myCode.cs.

// Load the type of the class.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load(typeof(bookOrders));

Comentarios

La herramienta xsltc.exe se usa para compilar hojas de estilos y generar ensamblados a partir de las hojas de estilos. El Load método carga la hoja de estilos compilada desde el ensamblado.

Nota

También debe incluir el ensamblado XSLT como referencia en la aplicación.

Consulte también

• Herramienta de ensamblado XSLT (xsltc.exe)
• Cómo: Realizar una transformación XSLT mediante un ensamblado
• Uso de la clase XslCompiledTransform

Load(String)

Source:

XslCompiledTransform.cs

Carga y compila la hoja de estilos situada en el URI especificado.

public:
 void Load(System::String ^ stylesheetUri);

public void Load (string stylesheetUri);

member this.Load : string -> unit

Public Sub Load (stylesheetUri As String)

Parámetros

stylesheetUri

String

URI de la hoja de estilos.

Excepciones

ArgumentNullException

El valor de stylesheetUri es null.

XsltException

La hoja de estilos contiene un error.

FileNotFoundException

No se puede encontrar la hoja de estilos.

DirectoryNotFoundException

El valor stylesheetUri incluye un nombre de archivo o un directorio que no se puede encontrar.

WebException

El valor stylesheetUri no se puede resolver.

o bien

Se produjo un error al procesar la solicitud.

UriFormatException

stylesheetUri no es un URI válido.

XmlException

Hubo un error de análisis al cargar la hoja de estilos.

Ejemplos

En el ejemplo siguiente se ejecuta una transformación y se genera en un archivo.

// 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")

Comentarios

La XslCompiledTransform clase admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe usar el http://www.w3.org/1999/XSL/Transform espacio de nombres .

Este método tiene el siguiente comportamiento:

• Sin XmlUrlResolver credenciales de usuario se usa para resolver el URI de la hoja de estilos y procesar los xsl:import elementos o xsl:include .

• Con XmlReader la configuración predeterminada se usa para cargar la hoja de estilos. El procesamiento de DTD está deshabilitado en .XmlReader Si necesita el procesamiento de DTD, cree un XmlReader con esta característica habilitada y páselo al Load método .

• La document() función está deshabilitada.

• No se admiten scripts incrustados.

Puede usar la Load(String, XsltSettings, XmlResolver) sobrecarga para especificar un XmlResolver objeto con las credenciales de autenticación necesarias o para especificar una configuración XSLT diferente.

Consulte también

• Uso de la clase XslCompiledTransform

Load(IXPathNavigable)

Source:

XslCompiledTransform.cs

Compila la hoja de estilos incluida en el objeto IXPathNavigable.

public:
 void Load(System::Xml::XPath::IXPathNavigable ^ stylesheet);

public void Load (System.Xml.XPath.IXPathNavigable stylesheet);

member this.Load : System.Xml.XPath.IXPathNavigable -> unit

Public Sub Load (stylesheet As IXPathNavigable)

Parámetros

stylesheet

IXPathNavigable

Un objeto que implementa la interfaz IXPathNavigable. En Microsoft .NET Framework, puede ser una clase XmlNode (normalmente una clase XmlDocument) o una clase XPathDocument que contiene la hoja de estilos.

Excepciones

ArgumentNullException

El valor de stylesheet es null.

XsltException

La hoja de estilos contiene un error.

Ejemplos

En el ejemplo siguiente se carga una hoja de estilos contenida en un XPathDocument objeto .

XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load(new XPathDocument("http://serverName/data/xsl/sort.xsl"));

Dim xslt As New XslCompiledTransform()
xslt.Load(New XPathDocument("http://serverName/data/xsl/sort.xsl"))

Comentarios

La XslCompiledTransform clase admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe usar el http://www.w3.org/1999/XSL/Transform espacio de nombres .

Este método tiene el siguiente comportamiento:

• Sin XmlUrlResolver credenciales de usuario se usa para procesar elementos xsl:import o xsl:include .

• La document() función está deshabilitada.

• No se admiten scripts incrustados.

Puede usar la Load sobrecarga para especificar un XmlResolver objeto con las credenciales de autenticación necesarias o para especificar una configuración XSLT diferente.

Consulte también

• Uso de la clase XslCompiledTransform