XslTransform.Load Método

Referencia

Definición

Espacio de nombres:: System.Xml.Xsl

Ensamblado:: System.Xml.dll

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Carga la hoja de estilos XSLT, incluidas las hojas de estilos a las que se hace referencia en los elementos xsl:include e xsl:import.

Sobrecargas

Load(XPathNavigator, XmlResolver, Evidence)	Carga la hoja de estilos XSLT incluida en el objeto XPathNavigator. Este método permite limitar los permisos de la hoja de estilos por medio de la especificación de la evidencia.
Load(IXPathNavigable, XmlResolver, Evidence)	Carga la hoja de estilos XSLT incluida en el objeto IXPathNavigable. Este método permite limitar los permisos de la hoja de estilos por medio de la especificación de la evidencia.
Load(XPathNavigator, XmlResolver)	Obsoleto. Carga la hoja de estilos XSLT incluida en el objeto XPathNavigator.
Load(IXPathNavigable, XmlResolver)	Obsoleto. Carga la hoja de estilos XSLT incluida en el objeto IXPathNavigable.
Load(XmlReader, XmlResolver)	Obsoleto. Carga la hoja de estilos XSLT incluida en el objeto XmlReader.
Load(XmlReader, XmlResolver, Evidence)	Carga la hoja de estilos XSLT incluida en el objeto XmlReader. Este método permite limitar los permisos de la hoja de estilos por medio de la especificación de la evidencia.
Load(XPathNavigator)	Obsoleto. Carga la hoja de estilos XSLT incluida en el objeto XPathNavigator.
Load(IXPathNavigable)	Obsoleto. Carga la hoja de estilos XSLT incluida en el objeto IXPathNavigable.
Load(XmlReader)	Obsoleto. Carga la hoja de estilos XSLT incluida en el objeto XmlReader.
Load(String)	Carga la hoja de estilos XSLT especificada por una dirección URL.
Load(String, XmlResolver)	Carga la hoja de estilos XSLT especificada por una dirección URL.

Comentarios

Nota

La XslTransform clase está obsoleta en .NET Framework versión 2.0. La XslCompiledTransform clase es el nuevo procesador XSLT. Para obtener más información, vea Usar la clase XslCompiledTransform y Migrar desde la clase XslTransform.

Load(XPathNavigator, XmlResolver, Evidence)

Carga la hoja de estilos XSLT incluida en el objeto XPathNavigator. Este método permite limitar los permisos de la hoja de estilos por medio de la especificación de la evidencia.

public:
 void Load(System::Xml::XPath::XPathNavigator ^ stylesheet, System::Xml::XmlResolver ^ resolver, System::Security::Policy::Evidence ^ evidence);

public void Load (System.Xml.XPath.XPathNavigator stylesheet, System.Xml.XmlResolver resolver, System.Security.Policy.Evidence evidence);

member this.Load : System.Xml.XPath.XPathNavigator * System.Xml.XmlResolver * System.Security.Policy.Evidence -> unit

Public Sub Load (stylesheet As XPathNavigator, resolver As XmlResolver, evidence As Evidence)

Parámetros

stylesheet: XPathNavigator

Objeto XPathNavigator que contiene la hoja de estilos que se va a cargar.

resolver: XmlResolver

XmlResolver se usa para cargar la hoja de estilos y cualquier hoja u hojas de estilos a las que se haga referencia en los elementos xsl:import y xsl:include. Si es null, los recursos externos no se resuelven.

XmlResolver no se almacena en caché una vez finalizado el método Load.

evidence: Evidence

Evidence que se establece en el ensamblado generado para el bloque de script en la hoja de estilos XLST.

Si es null, no se procesan los bloques de script, no se admite la función document() XSLT y no se permiten los objetos de extensión privilegiada.

El llamador debe disponer de un permiso ControlEvidence para suministrar la evidencia al ensamblado de script. Los llamadores de confianza parcial pueden establecer este parámetro en null.

Excepciones

XsltCompileException

El nodo actual no cumple los requisitos de una hoja de estilos válida.

SecurityException

La hoja de estilos a la que se hace referencia requiere una funcionalidad no permitida por la evidencia proporcionada.

El llamador intenta proporcionar la evidencia, pero no dispone de un permiso ControlEvidence.

Ejemplos

En el ejemplo siguiente se realiza una transformación XSLT mediante una hoja de estilos de un origen externo. Dado que la hoja de estilos procede de un origen que no es de confianza, los resolver parámetros y evidence se establecen en null.


public static void TransformFile (XPathNavigator xsltNav) {

 // Load the stylesheet.
 XslTransform xslt = new XslTransform();
 xslt.Load(xsltNav, null, null);

 // Transform the file.
 xslt.Transform("books.xml", "books.html", null);
}


public shared sub TransformFile (xsltNav as XPathNavigator) 
 
 ' Load the stylesheet.
 Dim xslt as XslTransform = new XslTransform()
 xslt.Load(xsltNav, nothing, nothing)

 ' Transform the file.
 xslt.Transform("books.xml", "books.html", nothing)
end sub

Comentarios

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

La hoja de estilos se carga desde la posición actual de XPathNavigator. Para usar una parte del documento cargado como hoja de estilos, vaya al nodo correspondiente al principio de la hoja de estilos. Una vez devuelto el Load método , el XPathNavigator objeto se coloca al principio de la hoja de estilos (en el xsl:style sheet nodo).

Hay diferentes maneras de proporcionar evidencia. En la tabla siguiente se describe qué tipo de evidencia proporcionar para escenarios de usuario comunes.

Escenario	Tipo de evidencia que se va a proporcionar
La hoja de estilos XSLT es independiente o procede de una base de código en la que confía.	Use la evidencia del ensamblado. `XsltTransform xslt = new XslTransform(); xslt.Load(xslNav, resolver, this.GetType().Assembly.Evidence);`
La hoja de estilos XSLT proviene de un código fuente exterior. Se conoce el origen del origen y hay una dirección URL verificable.	Cree evidencia mediante la dirección URL. `XsltTransform xslt = new XslTransform(); Evidence evidence = XmlSecureResolver.CreateEvidenceForUrl(style sheetURL); xslt.Load(xslNav,resolver,evidence);`
La hoja de estilos XSLT proviene de un código fuente exterior. Se desconoce el origen del código fuente.	Establezca la evidencia en `null`. No se procesan los bloques de scripts, no se admite la función `document()` de XSLT y no están permitidos los objetos de extensión privilegiada. Además, también puede establecer el `resolver` parámetro en `null`. Esto garantiza que `xsl:import` los elementos y `xsl:include` no se procesen.
La hoja de estilos XSLT proviene de un código fuente exterior. Se desconoce el origen del código fuente, pero es necesaria la compatibilidad con los scripts.	Solicite la evidencia al llamador. La API del autor de la llamada debe proporcionar una manera de proporcionar evidencia, normalmente la `Evidence` clase .

Consulte también

Se aplica a

Load(IXPathNavigable, XmlResolver, Evidence)

Carga la hoja de estilos XSLT incluida en el objeto IXPathNavigable. Este método permite limitar los permisos de la hoja de estilos por medio de la especificación de la evidencia.

public:
 void Load(System::Xml::XPath::IXPathNavigable ^ stylesheet, System::Xml::XmlResolver ^ resolver, System::Security::Policy::Evidence ^ evidence);

public void Load (System.Xml.XPath.IXPathNavigable stylesheet, System.Xml.XmlResolver resolver, System.Security.Policy.Evidence evidence);

member this.Load : System.Xml.XPath.IXPathNavigable * System.Xml.XmlResolver * System.Security.Policy.Evidence -> unit

Public Sub Load (stylesheet As IXPathNavigable, resolver As XmlResolver, evidence As Evidence)

Parámetros

stylesheet: IXPathNavigable

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

resolver: XmlResolver

XmlResolver no se almacena en caché una vez finalizado el método Load.

evidence: Evidence

Evidence que se establece en el ensamblado generado para el bloque de script en la hoja de estilos XLST.

Si es null, no se procesan los bloques de script, no se admite la función document() XSLT y no se permiten los objetos de extensión privilegiada.

El llamador debe disponer de un permiso ControlEvidence para suministrar la evidencia al ensamblado de script. Los llamadores de confianza parcial pueden establecer este parámetro en null.

Excepciones

XsltCompileException

El recurso cargado no es una hoja de estilos válida.

SecurityException

La hoja de estilos a la que se hace referencia requiere una funcionalidad no permitida por la evidencia proporcionada.

El llamador intenta proporcionar la evidencia, pero no dispone de un permiso ControlEvidence.

Comentarios

Nota

La clase XslTransform está obsoleta en .NET Framework versión 2.0. La XslCompiledTransform clase es el nuevo procesador XSLT. Para obtener más información, vea Usar la clase XslCompiledTransform y Migrar desde la clase XslTransform.

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

Hay diferentes maneras de proporcionar evidencia. En la tabla siguiente se describe qué tipo de evidencia proporcionar para escenarios de usuario comunes.

Escenario	Tipo de evidencia que se va a proporcionar
La hoja de estilos XSLT es independiente o procede de una base de código en la que confía.	Use la evidencia del ensamblado. `XsltTransform xslt = new XslTransform(); xslt.Load(style sheet, resolver, this.GetType().Assembly.Evidence);`
La hoja de estilos XSLT proviene de un código fuente exterior. Se conoce el origen del origen y hay una dirección URL verificable.	Cree evidencia mediante la dirección URL. `XsltTransform xslt = new XslTransform(); Evidence evidence = XmlSecureResolver.CreateEvidenceForUrl(style sheetURL); xslt.Load(style sheet,resolver,evidence);`
La hoja de estilos XSLT proviene de un código fuente exterior. Se desconoce el origen del código fuente.	Establezca la evidencia en `null`. No se procesan los bloques de scripts, no se admite la función `document()` de XSLT y no están permitidos los objetos de extensión privilegiada. Además, también puede establecer el `resolver` parámetro en `null`. Esto garantiza que `xsl:import` los elementos y `xsl:include` no se procesen.
La hoja de estilos XSLT proviene de un código fuente exterior. Se desconoce el origen del código fuente, pero es necesaria la compatibilidad con los scripts.	Solicite la evidencia al llamador. La API del autor de la llamada debe proporcionar una manera de proporcionar evidencia, normalmente la Evidence clase .

Consulte también

Se aplica a

Load(XPathNavigator, XmlResolver)

Precaución

You should pass evidence to Load() method

Carga la hoja de estilos XSLT incluida en el objeto XPathNavigator.

public:
 void Load(System::Xml::XPath::XPathNavigator ^ stylesheet, System::Xml::XmlResolver ^ resolver);

public void Load (System.Xml.XPath.XPathNavigator stylesheet, System.Xml.XmlResolver? resolver);

public void Load (System.Xml.XPath.XPathNavigator stylesheet, System.Xml.XmlResolver resolver);

[System.Obsolete("You should pass evidence to Load() method")]
public void Load (System.Xml.XPath.XPathNavigator stylesheet, System.Xml.XmlResolver resolver);

member this.Load : System.Xml.XPath.XPathNavigator * System.Xml.XmlResolver -> unit

[<System.Obsolete("You should pass evidence to Load() method")>]
member this.Load : System.Xml.XPath.XPathNavigator * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheet As XPathNavigator, resolver As XmlResolver)

Parámetros

stylesheet: XPathNavigator

Objeto XPathNavigator que contiene la hoja de estilos XSLT.

resolver: XmlResolver

XmlResolver no se almacena en caché una vez finalizado el método Load.

Atributos: ObsoleteAttribute

Excepciones

XsltCompileException

El nodo actual no cumple los requisitos de una hoja de estilos válida.

SecurityException

La hoja de estilos contiene scripts incrustados y el llamador no dispone de un permiso UnmanagedCode.

Comentarios

Nota

La XslTransform clase está obsoleta en la versión 2.0 de .NET Framework. La XslCompiledTransform clase es el nuevo procesador XSLT. Para obtener más información, vea Usar la clase XslCompiledTransform y Migrar desde la clase XslTransform.

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

La hoja de estilos se carga desde la posición actual de XPathNavigator. Para usar una parte del documento cargado como hoja de estilos, vaya al nodo correspondiente al principio de la hoja de estilos. Una vez que el Load método devuelve, XPathNavigator se coloca al principio de la hoja de estilos (en el xsl:style sheet nodo).

Si la hoja de estilos contiene scripts incrustados, el script se compila en un ensamblado. El ensamblado tiene plena confianza. La práctica recomendada es proporcionar pruebas mediante Load(XPathNavigator, XmlResolver, Evidence).

Nota

Si el autor de la llamada no tiene UnmanagedCode permiso, el script incrustado no se compila y se produce una SecurityException excepción . Para obtener más información, vea SecurityPermission y SecurityPermissionFlag.UnmanagedCode.

Consulte también

Se aplica a

Load(IXPathNavigable, XmlResolver)

Precaución

You should pass evidence to Load() method

Carga la hoja de estilos XSLT incluida en el objeto IXPathNavigable.

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

public void Load (System.Xml.XPath.IXPathNavigable stylesheet, System.Xml.XmlResolver? resolver);

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

[System.Obsolete("You should pass evidence to Load() method")]
public void Load (System.Xml.XPath.IXPathNavigable stylesheet, System.Xml.XmlResolver resolver);

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

[<System.Obsolete("You should pass evidence to Load() method")>]
member this.Load : System.Xml.XPath.IXPathNavigable * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheet As IXPathNavigable, resolver As XmlResolver)

Parámetros

stylesheet: IXPathNavigable

resolver: XmlResolver

XmlResolver no se almacena en caché una vez finalizado el método Load.

Atributos: ObsoleteAttribute

Excepciones

XsltCompileException

El recurso cargado no es una hoja de estilos válida.

SecurityException

La hoja de estilos contiene scripts incrustados y el llamador no dispone de un permiso UnmanagedCode.

Comentarios

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

Si la hoja de estilos contiene scripts incrustados, el script se compila en un ensamblado. El ensamblado tiene plena confianza. La práctica recomendada es proporcionar evidencia mediante el Load(IXPathNavigable, XmlResolver, Evidence) método .

Nota

Consulte también

Se aplica a

Load(XmlReader, XmlResolver)

Precaución

You should pass evidence to Load() method

Carga la hoja de estilos XSLT incluida en el objeto XmlReader.

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

public void Load (System.Xml.XmlReader stylesheet, System.Xml.XmlResolver? resolver);

public void Load (System.Xml.XmlReader stylesheet, System.Xml.XmlResolver resolver);

[System.Obsolete("You should pass evidence to Load() method")]
public void Load (System.Xml.XmlReader stylesheet, System.Xml.XmlResolver resolver);

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

[<System.Obsolete("You should pass evidence to Load() method")>]
member this.Load : System.Xml.XmlReader * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheet As XmlReader, resolver As XmlResolver)

Parámetros

stylesheet: XmlReader

Objeto XmlReader que contiene la hoja de estilos XSLT.

resolver: XmlResolver

XmlResolver no se almacena en caché una vez finalizado el método Load(XmlReader, XmlResolver).

Atributos: ObsoleteAttribute

Excepciones

XsltCompileException

El nodo actual no cumple los requisitos de una hoja de estilos válida.

SecurityException

La hoja de estilos contiene scripts incrustados y el llamador no dispone de un permiso UnmanagedCode.

Comentarios

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

Este método carga la hoja de estilos XSLT, incluidas las hojas de estilos a las que se hace referencia en xsl:include los elementos y xsl:import . 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 devuelto 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.

Si la hoja de estilos contiene entidades, debe especificar que XmlReader pueda resolver entidades (XmlReader.CanResolveEntity devuelve true). En este caso, se puede usar .XmlValidatingReader

Nota

Consulte también

Se aplica a

Load(XmlReader, XmlResolver, Evidence)

Carga la hoja de estilos XSLT incluida en el objeto XmlReader. Este método permite limitar los permisos de la hoja de estilos por medio de la especificación de la evidencia.

public:
 void Load(System::Xml::XmlReader ^ stylesheet, System::Xml::XmlResolver ^ resolver, System::Security::Policy::Evidence ^ evidence);

public void Load (System.Xml.XmlReader stylesheet, System.Xml.XmlResolver resolver, System.Security.Policy.Evidence evidence);

member this.Load : System.Xml.XmlReader * System.Xml.XmlResolver * System.Security.Policy.Evidence -> unit

Public Sub Load (stylesheet As XmlReader, resolver As XmlResolver, evidence As Evidence)

Parámetros

stylesheet: XmlReader

Objeto XmlReader que contiene la hoja de estilos que se va a cargar.

resolver: XmlResolver

XmlResolver no se almacena en caché una vez finalizado el método Load.

evidence: Evidence

Evidence que se establece en el ensamblado generado para el bloque de script en la hoja de estilos XLST.

Si es null, no se procesan los bloques de script, no se admite la función document() XSLT y no se permiten los objetos de extensión privilegiada.

El llamador debe disponer de un permiso ControlEvidence para suministrar la evidencia al ensamblado de script. Los llamadores de confianza parcial pueden establecer este parámetro en null.

Excepciones

XsltCompileException

El nodo actual no cumple los requisitos de una hoja de estilos válida.

SecurityException

La hoja de estilos a la que se hace referencia requiere una funcionalidad no permitida por la evidencia proporcionada.

El llamador intenta proporcionar la evidencia, pero no dispone de un permiso ControlEvidence.

Ejemplos

En el ejemplo siguiente se realiza una transformación XSLT donde xsltReader contiene XmlReader una hoja de estilos y secureURL es una dirección URL de confianza que se puede usar para crear Evidence. El XmlSecureResolver.CreateEvidenceForUrl método se usa para crear Evidence , que se aplica a la hoja de estilos.

void TransformFile( XmlReader^ xsltReader, String^ secureURL )
{
   
   // Load the stylesheet using a default XmlUrlResolver and Evidence 
   // created using the trusted URL.
   XslTransform^ xslt = gcnew XslTransform;
   xslt->Load( xsltReader, gcnew XmlUrlResolver, XmlSecureResolver::CreateEvidenceForUrl( secureURL ) );
   
   // Transform the file.
   xslt->Transform("books.xml","books.html",gcnew XmlUrlResolver);
}


public static void TransformFile (XmlReader xsltReader, String secureURL) {

 // Load the stylesheet using a default XmlUrlResolver and Evidence
 // created using the trusted URL.
 XslTransform xslt = new XslTransform();
 xslt.Load(xsltReader, new XmlUrlResolver(), XmlSecureResolver.CreateEvidenceForUrl(secureURL));

 // Transform the file.
 xslt.Transform("books.xml", "books.html", new XmlUrlResolver());
}


public shared sub TransformFile (xsltReader as XmlReader, secureURL as String) 
 
 ' Load the stylesheet using a default XmlUrlResolver and Evidence 
 ' created using the trusted URL.
 Dim xslt as XslTransform = new XslTransform()
 xslt.Load(xsltReader, new XmlUrlResolver(), XmlSecureResolver.CreateEvidenceForUrl(secureURL))

 ' Transform the file.
 xslt.Transform("books.xml", "books.html", new XmlUrlResolver())
end sub

Comentarios

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

Una vez devuelto 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.

Si la hoja de estilos contiene entidades, debe especificar que XmlReader pueda resolver entidades (XmlReader.CanResolveEntity devuelve true). En este caso, se puede usar .XmlValidatingReader

Hay diferentes maneras de proporcionar evidencia. En la tabla siguiente se describe qué tipo de evidencia proporcionar para escenarios de usuario comunes.

Escenario	Tipo de evidencia que se va a proporcionar
La hoja de estilos XSLT es independiente o procede de una base de código que confía.	Use la evidencia del ensamblado. `XsltTransform xslt = new XslTransform(); xslt.Load(xslReader, resolver, this.GetType().Assembly.Evidence);`
La hoja de estilos XSLT proviene de un código fuente exterior. Se conoce el origen del origen y hay una dirección URL verificable.	Cree evidencia mediante la dirección URL. `XsltTransform xslt = new XslTransform(); Evidence evidence = XmlSecureResolver.CreateEvidenceForUrl(stylesheetURL); xslt.Load(xslReader,resolver,evidence);`
La hoja de estilos XSLT proviene de un código fuente exterior. Se desconoce el origen del código fuente.	Establezca la evidencia en `null`. No se procesan los bloques de scripts, no se admite la función `document()` de XSLT y no están permitidos los objetos de extensión privilegiada. Además, también puede establecer el `resolver` parámetro en `null`. Esto garantiza que `xsl:import` los elementos y `xsl:include` no se procesen.
La hoja de estilos XSLT proviene de un código fuente exterior. Se desconoce el origen del código fuente, pero es necesaria la compatibilidad con los scripts.	Solicite la evidencia al llamador. La API del autor de la llamada debe proporcionar una manera de proporcionar evidencia, normalmente la Evidence clase .

Consulte también

Se aplica a

Load(XPathNavigator)

Precaución

You should pass evidence to Load() method

Carga la hoja de estilos XSLT incluida en el objeto XPathNavigator.

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

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

[System.Obsolete("You should pass evidence to Load() method")]
public void Load (System.Xml.XPath.XPathNavigator stylesheet);

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

[<System.Obsolete("You should pass evidence to Load() method")>]
member this.Load : System.Xml.XPath.XPathNavigator -> unit

Public Sub Load (stylesheet As XPathNavigator)

Parámetros

stylesheet: XPathNavigator

Objeto XPathNavigator que contiene la hoja de estilos XSLT.

Atributos: ObsoleteAttribute

Excepciones

XsltCompileException

El nodo actual no cumple los requisitos de una hoja de estilos válida.

SecurityException

La hoja de estilos contiene scripts incrustados y el llamador no dispone de un permiso UnmanagedCode.

Comentarios

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

Este método carga la hoja de estilos XSLT, incluidas las hojas de estilos a las que se hace referencia en xsl:include los elementos y xsl:import . Los recursos externos se resuelven con una XmlUrlResolver sin credenciales de usuario. Si las hojas de estilos se encuentran en un recurso de red que requiere autenticación, use la sobrecarga que toma como XmlResolver uno de sus argumentos y especifique con XmlResolver las credenciales necesarias.

La hoja de estilos se carga desde la posición actual de XPathNavigator. Para usar solo una parte del documento cargado como hoja de estilos, vaya al nodo correspondiente al principio de la hoja de estilos. Una vez que el Load método devuelve, XPathNavigator se coloca al principio de la hoja de estilos (en el xsl:style sheet nodo).

Nota

Se aplica a

Load(IXPathNavigable)

Precaución

You should pass evidence to Load() method

Carga la hoja de estilos XSLT incluida en el objeto IXPathNavigable.

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

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

[System.Obsolete("You should pass evidence to Load() method")]
public void Load (System.Xml.XPath.IXPathNavigable stylesheet);

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

[<System.Obsolete("You should pass evidence to Load() method")>]
member this.Load : System.Xml.XPath.IXPathNavigable -> unit

Public Sub Load (stylesheet As IXPathNavigable)

Parámetros

stylesheet: IXPathNavigable

Atributos: ObsoleteAttribute

Excepciones

XsltCompileException

El recurso cargado no es una hoja de estilos válida.

SecurityException

La hoja de estilos contiene scripts incrustados y el llamador no dispone de un permiso UnmanagedCode.

Comentarios

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

Nota

Se aplica a

Load(XmlReader)

Precaución

You should pass evidence to Load() method

Carga la hoja de estilos XSLT incluida en el objeto XmlReader.

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

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

[System.Obsolete("You should pass evidence to Load() method")]
public void Load (System.Xml.XmlReader stylesheet);

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

[<System.Obsolete("You should pass evidence to Load() method")>]
member this.Load : System.Xml.XmlReader -> unit

Public Sub Load (stylesheet As XmlReader)

Parámetros

stylesheet: XmlReader

Objeto XmlReader que contiene la hoja de estilos XSLT.

Atributos: ObsoleteAttribute

Excepciones

XsltCompileException

El nodo actual no cumple los requisitos de una hoja de estilos válida.

SecurityException

La hoja de estilos contiene scripts incrustados y el llamador no dispone de un permiso UnmanagedCode.

Ejemplos

En el ejemplo siguiente se transforma un archivo XML que ordena todos los libros por título.

#using <System.Xml.dll>
#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Xsl;
using namespace System::Xml::XPath;
int main()
{
   String^ filename = "books.xml";
   String^ stylesheet = "titles.xsl";
   
   // Create the reader to load the stylesheet. 
   // Move the reader to the xsl:stylesheet node.
   XmlTextReader^ reader = gcnew XmlTextReader( stylesheet );
   reader->Read();
   reader->Read();
   
   // Create the XslTransform object and load the stylesheet.
   XslTransform^ xslt = gcnew XslTransform;
   xslt->Load( reader );
   
   // Load the file to transform.
   XPathDocument^ doc = gcnew XPathDocument( filename );
   
   // Create an XmlTextWriter which outputs to the console.
   XmlTextWriter^ writer = gcnew XmlTextWriter( Console::Out );
   
   // Transform the file and send the output to the console.
   xslt->Transform(doc,nullptr,writer);
   writer->Close();
}

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

public class Sample
{
  private const String filename = "books.xml";
  private const String stylesheet = "titles.xsl";

  public static void Main()
  {
    //Create the reader to load the stylesheet.
    //Move the reader to the xsl:stylesheet node.
    XmlTextReader reader = new XmlTextReader(stylesheet);
    reader.Read();
    reader.Read();

    //Create the XslTransform object and load the stylesheet.
    XslTransform xslt = new XslTransform();
    xslt.Load(reader);

    //Load the file to transform.
    XPathDocument doc = new XPathDocument(filename);

    //Create an XmlTextWriter which outputs to the console.
    XmlTextWriter writer = new XmlTextWriter(Console.Out);

    //Transform the file and send the output to the console.
    xslt.Transform(doc, null, writer);
    writer.Close();
  }
}

Imports System.IO
Imports System.Xml
Imports System.Xml.Xsl
Imports System.Xml.XPath

public class Sample

  private const filename as String = "books.xml"
  private const stylesheet as String = "titles.xsl"

  public shared sub Main()

    'Create the reader to load the stylesheet. 
    'Move the reader to the xsl:stylesheet node.
    Dim reader as XmlTextReader = new XmlTextReader(stylesheet)
    reader.Read()
    reader.Read()

    'Create the XslTransform object and load the stylesheet.
    Dim xslt as XslTransform = new XslTransform()
    xslt.Load(reader)

    'Load the file to transform.
    Dim doc as XPathDocument = new XPathDocument(filename)
             
    'Create an XmlTextWriter which outputs to the console.
    Dim writer as XmlTextWriter = new XmlTextWriter(Console.Out)

    'Transform the file and send the output to the console.
    xslt.Transform(doc, nothing, writer)
    writer.Close()  

  end sub
end class

En el ejemplo se usan los siguientes archivos de datos como entrada.

books.xml

<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>

titles.xsl

<!--Stylesheet to sort all books by title-->
<!--Created 2/13/2001-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:template match="bookstore">
      <books>
        <xsl:apply-templates select="book">
          <xsl:sort select="title"/>
        </xsl:apply-templates>
       </books>
   </xsl:template>
  <xsl:template match="book">
          <book><xsl:copy-of select="node()"/></book>
  </xsl:template>
</xsl:stylesheet>

Comentarios

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde 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 devuelto 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.

Si la hoja de estilos contiene entidades, debe especificar que XmlReader pueda resolver entidades (XmlReader.CanResolveEntity devuelve true). En este caso, se puede usar .XmlValidatingReader

Nota

Se aplica a

Load(String)

Carga la hoja de estilos XSLT especificada por una dirección URL.

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

public void Load (string url);

member this.Load : string -> unit

Public Sub Load (url As String)

Parámetros

url: String

La dirección URL que especifica la hoja de estilos XSLT a cargar.

Excepciones

XsltCompileException

El recurso cargado no es una hoja de estilos válida.

SecurityException

La hoja de estilos contiene un script incrustado y el llamador no dispone de un permiso UnmanagedCode.

Ejemplos

En el ejemplo siguiente se transforma un documento XML en un documento HTML. Muestra el ISBN, el título y el precio de cada libro de una tabla.

#using <System.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Xsl;
using namespace System::Xml::XPath;

int main()
{
   String^ filename = "books.xml";
   String^ stylesheet = "output.xsl";

   //Load the stylesheet.
   XslTransform^ xslt = gcnew XslTransform;
   xslt->Load( stylesheet );

   //Load the file to transform.
   XPathDocument^ doc = gcnew XPathDocument( filename );

   //Create an XmlTextWriter which outputs to the console.
   XmlTextWriter^ writer = gcnew XmlTextWriter( Console::Out );

   //Transform the file and send the output to the console.
   xslt->Transform(doc,nullptr,writer,nullptr);
   writer->Close();
}

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

public class Sample
{
  private const String filename = "books.xml";
  private const String stylesheet = "output.xsl";

  public static void Main()
  {
    //Load the stylesheet.
    XslTransform xslt = new XslTransform();
    xslt.Load(stylesheet);

    //Load the file to transform.
    XPathDocument doc = new XPathDocument(filename);

    //Create an XmlTextWriter which outputs to the console.
    XmlTextWriter writer = new XmlTextWriter(Console.Out);

    //Transform the file and send the output to the console.
    xslt.Transform(doc, null, writer, null);
    writer.Close();
  }
}

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml
Imports System.Xml.Xsl
Imports System.Xml.XPath

Public Class Sample
    Private Shared filename1 As String = "books.xml"
    Private Shared stylesheet1 As String = "output.xsl"
    
    
    Public Shared Sub Main()
        'Load the stylesheet.
        Dim xslt As New XslTransform()
        xslt.Load(stylesheet1)
        
        'Load the file to transform.
        Dim doc As New XPathDocument(filename1)
        
        'Create an XmlTextWriter which outputs to the console.
        Dim writer As New XmlTextWriter(Console.Out)
        
        'Transform the file and send the output to the console.
        xslt.Transform(doc, Nothing, writer, Nothing)
        writer.Close()
    End Sub
End Class

En el ejemplo se utilizan los dos archivos de entrada siguientes.

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

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl="http://www.w3.org/1999/XSL/Transform"de espacio de nombres .

Este método carga la hoja de estilos XSLT, incluidas las hojas de estilos a las que se hace referencia en xsl:include los elementos y xsl:import . Los recursos externos se resuelven mediante una XmlUrlResolver sin credenciales de usuario. Si las hojas de estilos se encuentran en un recurso de red que requiere autenticación, use la sobrecarga que toma como XmlResolver uno de sus argumentos y especifique una XmlResolver con las credenciales necesarias.

Si la hoja de estilos contiene scripts incrustados, el script se compila en un ensamblado. El URI de la hoja de estilos se usa para crear evidencia, que se aplica al ensamblado.

Nota

Se aplica a

Load(String, XmlResolver)

Carga la hoja de estilos XSLT especificada por una dirección URL.

public:
 void Load(System::String ^ url, System::Xml::XmlResolver ^ resolver);

public void Load (string url, System.Xml.XmlResolver? resolver);

public void Load (string url, System.Xml.XmlResolver resolver);

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

Public Sub Load (url As String, resolver As XmlResolver)

Parámetros

url: String

La dirección URL que especifica la hoja de estilos XSLT a cargar.

resolver: XmlResolver

XmlResolver que se usa para cargar la hoja de estilos y cualquier hoja u hojas de estilos a las que se haga referencia en los elementos xsl:import y xsl:include.

Si es null, se utiliza un XmlUrlResolver predeterminado sin credenciales del usuario para abrir la hoja de estilos. El objeto XmlUrlResolver predeterminado no se usa para resolver los recursos externos de la hoja de estilos, por lo que los elementos xsl:import y xsl:include quedan sin resolver.

XmlResolver no se almacena en caché una vez finalizado el método Load(String, XmlResolver).

Excepciones

XsltCompileException

El recurso cargado no es una hoja de estilos válida.

SecurityException

La hoja de estilos contiene un script incrustado y el llamador no dispone de un permiso UnmanagedCode.

Ejemplos

En el ejemplo siguiente se transforma un documento XML en un documento HTML. En el ejemplo se carga una hoja de estilos XSLT que contiene un xsl:include elemento que hace referencia a otra hoja de estilos. XmlUrlResolver Se pasa al Load método que establece las credenciales necesarias para acceder al recurso de red de la hoja de estilos incluida.

using System;
using System.IO;
using System.Xml;
using System.Xml.XPath;
using System.Xml.Xsl;
using System.Net;

public class Sample
{
   private const String filename = "books.xml";
   private const String stylesheet = "sort.xsl";

   public static void Main()
   {
      //Create the XslTransform.
     XslTransform xslt = new XslTransform();

     //Create a resolver and set the credentials to use.
     XmlUrlResolver resolver = new XmlUrlResolver();
     resolver.Credentials = CredentialCache.DefaultCredentials;

     //Load the stylesheet.
     xslt.Load(stylesheet, resolver);

     //Load the XML data file.
     XPathDocument doc = new XPathDocument(filename);

     //Create the XmlTextWriter to output to the console.
     XmlTextWriter writer = new XmlTextWriter(Console.Out);

     //Transform the file.
     xslt.Transform(doc, null, writer, null);
     writer.Close();
  }
}

Imports System.IO
Imports System.Xml
Imports System.Xml.XPath
Imports System.Xml.Xsl
Imports System.Net

public class Sample

   private shared filename as String = "books.xml"
   private shared stylesheet as String = "sort.xsl"

   public shared sub Main()
   
     'Create the XslTransform.
     Dim xslt as XslTransform = new XslTransform()

     'Create a resolver and set the credentials to use.
     Dim resolver as XmlUrlResolver = new XmlUrlResolver()
     resolver.Credentials = CredentialCache.DefaultCredentials

     'Load the stylesheet.
     xslt.Load(stylesheet, resolver)

     'Load the XML data file.
     Dim doc as XPathDocument = new XPathDocument(filename)

     'Create the XmlTextWriter to output to the console.             
     Dim writer as XmlTextWriter = new XmlTextWriter(Console.Out)

     'Transform the file.
     xslt.Transform(doc, nothing, writer, nothing)
     writer.Close()

  end sub
end class

En el ejemplo se usan los siguientes archivos de datos como entrada.

books.xml

<!-- 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>

sort.xsl

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:template match="bookstore"/>
  <xsl:include href="http://serverA/includefile.xsl"/>  
  <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>

includefile.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">
      <xsl:sort select="@ISBN"/>
    </xsl:apply-templates>
    </TABLE>
    </BODY>
  </HTML>
</xsl:template>
</xsl:stylesheet>

Comentarios

Nota

XslTransform admite la sintaxis XSLT 1.0. La hoja de estilos XSLT debe incluir la declaración xmlns:xsl= http://www.w3.org/1999/XSL/Transformde espacio de nombres .

Si la hoja de estilos contiene scripts incrustados, el script se compila en un ensamblado. El URI de la hoja de estilos se usa para crear evidencia, que se aplica al ensamblado.

Nota

Consulte también

Se aplica a

XslTransform.Load Método

Definición

Sobrecargas

Comentarios

Load(XPathNavigator, XmlResolver, Evidence)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Load(IXPathNavigable, XmlResolver, Evidence)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Load(XPathNavigator, XmlResolver)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Load(IXPathNavigable, XmlResolver)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Load(XmlReader, XmlResolver)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Load(XmlReader, XmlResolver, Evidence)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Load(XPathNavigator)

Parámetros

Excepciones

Comentarios

Se aplica a

Load(IXPathNavigable)

Parámetros

Excepciones

Comentarios

Se aplica a

Load(XmlReader)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Load(String)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Load(String, XmlResolver)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales