XslTransform.Load Método

Referência

Definição

Namespace:: System.Xml.Xsl

Assembly:: System.Xml.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Carrega a folha de estilos XSLT, incluindo folhas de estilo referenciadas nos elementos xsl:include e xsl:import.

Sobrecargas

Load(XPathNavigator, XmlResolver, Evidence)	Carrega a folha de estilos XSLT contida no XPathNavigator. Esse método permite que você limite as permissões da folha de estilos especificando a evidência.
Load(IXPathNavigable, XmlResolver, Evidence)	Carrega a folha de estilos XSLT contida no IXPathNavigable. Esse método permite que você limite as permissões da folha de estilos especificando a evidência.
Load(XPathNavigator, XmlResolver)	Obsoleto. Carrega a folha de estilos XSLT contida no XPathNavigator.
Load(IXPathNavigable, XmlResolver)	Obsoleto. Carrega a folha de estilos XSLT contida no IXPathNavigable.
Load(XmlReader, XmlResolver)	Obsoleto. Carrega a folha de estilos XSLT contida no XmlReader.
Load(XmlReader, XmlResolver, Evidence)	Carrega a folha de estilos XSLT contida no XmlReader. Esse método permite que você limite as permissões da folha de estilos especificando a evidência.
Load(XPathNavigator)	Obsoleto. Carrega a folha de estilos XSLT contida no XPathNavigator.
Load(IXPathNavigable)	Obsoleto. Carrega a folha de estilos XSLT contida no IXPathNavigable.
Load(XmlReader)	Obsoleto. Carrega a folha de estilos XSLT contida no XmlReader.
Load(String)	Carrega a folha de estilos XSLT especificada por uma URL.
Load(String, XmlResolver)	Carrega a folha de estilos XSLT especificada por uma URL.

Comentários

Observação

A XslTransform classe está obsoleta no .NET Framework versão 2.0. A XslCompiledTransform classe é o novo processador XSLT. Para obter mais informações, consulte Usando a classe XslCompiledTransform e migrando da classe XslTransform.

Load(XPathNavigator, XmlResolver, Evidence)

Carrega a folha de estilos XSLT contida no XPathNavigator. Esse método permite que você limite as permissões da folha de estilos especificando a evidência.

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

Um objeto XPathNavigator que contém a folha de estilos a ser carregada.

resolver: XmlResolver

O XmlResolver usado para carregar as folhas de estilos referenciadas nos elementos xsl:import e xsl:include. Se for null, os recursos externos não serão resolvidos.

O XmlResolver não é armazenado em cache após o método Load ser concluído.

evidence: Evidence

O Evidence definido no assembly gerado para o bloco de script na folha de estilos XSLT.

Se for null, os blocos de script não serão processados, a função XSLT document() não terá suporte e objetos de extensão privilegiados não serão permitidos.

O chamador deve ter a permissão ControlEvidence para fornecer a evidência do assembly de script. Chamadores de confiança parcial podem definir esse parâmetro como null.

Exceções

XsltCompileException

O nó atual não está em conformidade com uma folha de estilos válida.

SecurityException

A folha de estilos referenciada requer uma funcionalidade que não é permitida pela evidência fornecida.

O chamador tenta fornecer a evidência e não tem a permissão ControlEvidence.

Exemplos

O exemplo a seguir executa uma transformação XSLT usando uma folha de estilos de uma fonte externa. Como a folha de estilos vem de uma origem não confiável, os parâmetros e evidence os resolver parâmetros são definidos como 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

Comentários

Observação

A XslTransform classe está obsoleta no .NET Framework versão 2.0. A XslCompiledTransform classe é o novo processador XSLT. Para obter mais informações, consulte Como usar a classe XslCompiledTransform e migrar da classe XslTransform.

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

A folha de estilos é carregada da posição atual do XPathNavigator. Para usar uma parte do documento carregado como a folha de estilos, navegue até o nó correspondente ao início da folha de estilos. Depois que o Load método retorna, ele XPathNavigator é posicionado no início da folha de estilos (no xsl:style sheet nó).

Há diferentes maneiras de fornecer evidências. A tabela a seguir descreve que tipo de evidência fornecer para cenários comuns de usuário.

Cenário	Tipo de evidência a ser fornecida
A folha de estilos XSLT é independente ou vem de uma base de código em que você confia.	Use a evidência do assembly. `XsltTransform xslt = new XslTransform(); xslt.Load(xslNav, resolver, this.GetType().Assembly.Evidence);`
A folha de estilos XSLT vem de uma fonte externa. A origem da origem é conhecida e há uma URL verificável.	Crie evidências usando a URL. `XsltTransform xslt = new XslTransform(); Evidence evidence = XmlSecureResolver.CreateEvidenceForUrl(style sheetURL); xslt.Load(xslNav,resolver,evidence);`
A folha de estilos XSLT vem de uma fonte externa. A origem de origem não é conhecida.	Defina a evidência a `null`. Blocos de script não são processados, a função XSLT `document()` não é suportada, e objetos privilegiados de extensão não é permitida. Além disso, você também pode definir o `resolver` parâmetro como `null`. Isso garante que `xsl:import` e `xsl:include` os elementos não sejam processados.
A folha de estilos XSLT vem de uma fonte externa. A origem de origem não é conhecido, mas você precisar de suporte de script.	Evidência de solicitação do chamador. A API do chamador deve fornecer uma maneira de fornecer evidências, normalmente a `Evidence` classe.

Confira também

Aplica-se a

Load(IXPathNavigable, XmlResolver, Evidence)

Carrega a folha de estilos XSLT contida no IXPathNavigable. Esse método permite que você limite as permissões da folha de estilos especificando a evidência.

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

Um objeto que implementa a interface IXPathNavigable. No .NET Framework, isso pode ser um XmlNode (normalmente um XmlDocument) ou um XPathDocument que contém a folha de estilos XSLT.

resolver: XmlResolver

O XmlResolver usado para carregar as folhas de estilos referenciadas nos elementos xsl:import e xsl:include. Se for null, os recursos externos não serão resolvidos.

O XmlResolver não é armazenado em cache após o método Load ser concluído.

evidence: Evidence

O Evidence definido no assembly gerado para o bloco de script na folha de estilos XSLT.

Se for null, os blocos de script não serão processados, a função XSLT document() não terá suporte e objetos de extensão privilegiados não serão permitidos.

O chamador deve ter a permissão ControlEvidence para fornecer a evidência do assembly de script. Chamadores de confiança parcial podem definir esse parâmetro como null.

Exceções

XsltCompileException

O recurso carregado não é uma folha de estilos válida.

SecurityException

A folha de estilos referenciada requer uma funcionalidade que não é permitida pela evidência fornecida.

O chamador tenta fornecer a evidência e não tem a permissão ControlEvidence.

Comentários

Observação

A classe XslTransform está obsoleta no .NET Framework versão 2.0. A XslCompiledTransform classe é o novo processador XSLT. Para obter mais informações, consulte Como usar a classe XslCompiledTransform e migrar da classe XslTransform.

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

Há diferentes maneiras de fornecer evidências. A tabela a seguir descreve que tipo de evidência fornecer para cenários comuns de usuário.

Cenário	Tipo de evidência a ser fornecida
A folha de estilos XSLT é independente ou vem de uma base de código em que você confia.	Use a evidência do assembly. `XsltTransform xslt = new XslTransform(); xslt.Load(style sheet, resolver, this.GetType().Assembly.Evidence);`
A folha de estilos XSLT vem de uma fonte externa. A origem da origem é conhecida e há uma URL verificável.	Crie evidências usando a URL. `XsltTransform xslt = new XslTransform(); Evidence evidence = XmlSecureResolver.CreateEvidenceForUrl(style sheetURL); xslt.Load(style sheet,resolver,evidence);`
A folha de estilos XSLT vem de uma fonte externa. A origem de origem não é conhecida.	Defina a evidência a `null`. Blocos de script não são processados, a função XSLT `document()` não é suportada, e objetos privilegiados de extensão não é permitida. Além disso, você também pode definir o `resolver` parâmetro como `null`. Isso garante que `xsl:import` e `xsl:include` os elementos não sejam processados.
A folha de estilos XSLT vem de uma fonte externa. A origem de origem não é conhecido, mas você precisar de suporte de script.	Evidência de solicitação do chamador. A API do chamador deve fornecer uma maneira de fornecer evidências, normalmente a Evidence classe.

Confira também

Aplica-se a

Load(XPathNavigator, XmlResolver)

Cuidado

You should pass evidence to Load() method

Carrega a folha de estilos XSLT contida no 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

Um objeto XPathNavigator que contém a folha de estilos XSLT.

resolver: XmlResolver

O XmlResolver usado para carregar as folhas de estilos referenciadas nos elementos xsl:import e xsl:include. Se for null, os recursos externos não serão resolvidos.

O XmlResolver não é armazenado em cache após o método Load ser concluído.

Atributos: ObsoleteAttribute

Exceções

XsltCompileException

O nó atual não está em conformidade com uma folha de estilos válida.

SecurityException

A folha de estilos contém scripts inseridos e o chamador não tem permissão de UnmanagedCode.

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

Se a folha de estilos contiver scripts inseridos, o script será compilado em um assembly. O assembly tem total confiança. A prática recomendada é fornecer evidências usando o Load(XPathNavigator, XmlResolver, Evidence).

Observação

Se o chamador não tiver UnmanagedCode permissão, o script inserido não será compilado e será SecurityException gerado. Consulte SecurityPermission e SecurityPermissionFlag.UnmanagedCode para obter mais informações.

Confira também

Aplica-se a

Load(IXPathNavigable, XmlResolver)

Cuidado

You should pass evidence to Load() method

Carrega a folha de estilos XSLT contida no 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

Um objeto que implementa a interface IXPathNavigable. No .NET Framework, isso pode ser um XmlNode (normalmente um XmlDocument) ou um XPathDocument que contém a folha de estilos XSLT.

resolver: XmlResolver

O XmlResolver usado para carregar as folhas de estilos referenciadas nos elementos xsl:import e xsl:include. Se for null, os recursos externos não serão resolvidos.

O XmlResolver não é armazenado em cache após o método Load ser concluído.

Atributos: ObsoleteAttribute

Exceções

XsltCompileException

O recurso carregado não é uma folha de estilos válida.

SecurityException

A folha de estilos contém scripts inseridos e o chamador não tem permissão de UnmanagedCode.

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

Observação

Confira também

Aplica-se a

Load(XmlReader, XmlResolver)

Cuidado

You should pass evidence to Load() method

Carrega a folha de estilos XSLT contida no 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

Um objeto XmlReader que contém a folha de estilos XSLT.

resolver: XmlResolver

O XmlResolver usado para carregar as folhas de estilos referenciadas nos elementos xsl:import e xsl:include. Se for null, os recursos externos não serão resolvidos.

O XmlResolver não é armazenado em cache após o método Load(XmlReader, XmlResolver) ser concluído.

Atributos: ObsoleteAttribute

Exceções

XsltCompileException

O nó atual não está em conformidade com uma folha de estilos válida.

SecurityException

A folha de estilos contém scripts inseridos e o chamador não tem permissão de UnmanagedCode.

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

Esse método carrega a folha de estilos XSLT, incluindo quaisquer folhas de estilo referenciadas e xsl:include xsl:import elementos. A folha de estilos é carregada do nó atual de XmlReader todos os seus filhos. Isso permite que você use uma parte de um documento como a folha de estilos.

Depois que o Load método é retornado, ele XmlReader é posicionado no próximo nó após o final da folha de estilos. Se o final do documento é alcançada, XmlReader está localizado no final do arquivo (EOF).

Se a folha de estilos contiver entidades, você deverá especificar um XmlReader que possa resolver entidades (XmlReader.CanResolveEntity retorna true). Nesse caso, um XmlValidatingReader pode ser usado.

Observação

Confira também

Aplica-se a

Load(XmlReader, XmlResolver, Evidence)

Carrega a folha de estilos XSLT contida no XmlReader. Esse método permite que você limite as permissões da folha de estilos especificando a evidência.

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

Um objeto XmlReader que contém a folha de estilos a ser carregada.

resolver: XmlResolver

O XmlResolver usado para carregar as folhas de estilos referenciadas nos elementos xsl:import e xsl:include. Se for null, os recursos externos não serão resolvidos.

O XmlResolver não é armazenado em cache após o método Load ser concluído.

evidence: Evidence

O Evidence definido no assembly gerado para o bloco de script na folha de estilos XSLT.

Se for null, os blocos de script não serão processados, a função XSLT document() não terá suporte e objetos de extensão privilegiados não serão permitidos.

O chamador deve ter a permissão ControlEvidence para fornecer a evidência do assembly de script. Chamadores de confiança parcial podem definir esse parâmetro como null.

Exceções

XsltCompileException

O nó atual não está em conformidade com uma folha de estilos válida.

SecurityException

A folha de estilos referenciada requer uma funcionalidade que não é permitida pela evidência fornecida.

O chamador tenta fornecer a evidência e não tem a permissão ControlEvidence.

Exemplos

O exemplo a seguir executa uma transformação XSLT em xsltReader que é uma XmlReader folha de estilos que contém e secureURL é uma URL confiável que pode ser usada para criar Evidence. O XmlSecureResolver.CreateEvidenceForUrl método é usado para criar Evidence o que é aplicado à folha 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

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

Há diferentes maneiras de fornecer evidências. A tabela a seguir descreve que tipo de evidência fornecer para cenários comuns de usuário.

Cenário	Tipo de evidência a ser fornecida
A folha de estilos XSLT é independente ou vem de uma base de código em que você confia.	Use a evidência do assembly. `XsltTransform xslt = new XslTransform(); xslt.Load(xslReader, resolver, this.GetType().Assembly.Evidence);`
A folha de estilos XSLT vem de uma fonte externa. A origem da origem é conhecida e há uma URL verificável.	Crie evidências usando a URL. `XsltTransform xslt = new XslTransform(); Evidence evidence = XmlSecureResolver.CreateEvidenceForUrl(stylesheetURL); xslt.Load(xslReader,resolver,evidence);`
A folha de estilos XSLT vem de uma fonte externa. A origem de origem não é conhecida.	Defina a evidência a `null`. Blocos de script não são processados, a função XSLT `document()` não é suportada, e objetos privilegiados de extensão não é permitida. Além disso, você também pode definir o `resolver` parâmetro como `null`. Isso garante que `xsl:import` e `xsl:include` os elementos não sejam processados.
A folha de estilos XSLT vem de uma fonte externa. A origem de origem não é conhecido, mas você precisar de suporte de script.	Evidência de solicitação do chamador. A API do chamador deve fornecer uma maneira de fornecer evidências, normalmente a Evidence classe.

Confira também

Aplica-se a

Load(XPathNavigator)

Cuidado

You should pass evidence to Load() method

Carrega a folha de estilos XSLT contida no 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

Um objeto XPathNavigator que contém a folha de estilos XSLT.

Atributos: ObsoleteAttribute

Exceções

XsltCompileException

O nó atual não está em conformidade com uma folha de estilos válida.

SecurityException

A folha de estilos contém scripts inseridos e o chamador não tem permissão de UnmanagedCode.

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

Esse método carrega a folha de estilos XSLT, incluindo quaisquer folhas de estilo referenciadas e xsl:include xsl:import elementos. Os recursos externos são resolvidos usando um XmlUrlResolver sem credenciais de usuário. Se as folhas de estilos estiverem localizadas em um recurso de rede que requer autenticação, use a sobrecarga que usa um XmlResolver como um de seus argumentos e especifique um XmlResolver com as credenciais necessárias.

A folha de estilos é carregada da posição atual do XPathNavigator. Para usar apenas uma parte do documento carregado como a folha de estilos, navegue até o nó correspondente ao início da folha de estilos. Depois que o Load método retorna, ele XPathNavigator é posicionado no início da folha de estilos (no xsl:style sheet nó).

Observação

Se o chamador não tiver UnmanagedCode permissão, o script inserido não será compilado e um SecurityException será lançado. Consulte SecurityPermission e SecurityPermissionFlag.UnmanagedCode para obter mais informações.

Aplica-se a

Load(IXPathNavigable)

Cuidado

You should pass evidence to Load() method

Carrega a folha de estilos XSLT contida no 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

Um objeto que implementa a interface IXPathNavigable. No .NET Framework, isso pode ser um XmlNode (normalmente um XmlDocument) ou um XPathDocument que contém a folha de estilos XSLT.

Atributos: ObsoleteAttribute

Exceções

XsltCompileException

O recurso carregado não é uma folha de estilos válida.

SecurityException

A folha de estilos contém scripts inseridos e o chamador não tem permissão de UnmanagedCode.

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

Observação

Aplica-se a

Load(XmlReader)

Cuidado

You should pass evidence to Load() method

Carrega a folha de estilos XSLT contida no 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

Um objeto XmlReader que contém a folha de estilos XSLT.

Atributos: ObsoleteAttribute

Exceções

XsltCompileException

O nó atual não está em conformidade com uma folha de estilos válida.

SecurityException

A folha de estilos contém scripts inseridos e o chamador não tem permissão de UnmanagedCode.

Exemplos

O exemplo a seguir transforma um arquivo XML classificando todos os livros 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

O exemplo usa os arquivos de dados a seguir 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>

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

A folha de estilos é carregada do nó atual de XmlReader todos os seus filhos. Isso permite que você use uma parte de um documento como a folha de estilos. Depois que o Load método é retornado, ele XmlReader é posicionado no próximo nó após o fim da folha de estilos. Se o final do documento é alcançada, XmlReader está localizado no final do arquivo (EOF).

Observação

Aplica-se a

Load(String)

Carrega a folha de estilos XSLT especificada por uma 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

A URL que especifica a folha de estilos XSLT a ser carregada.

Exceções

XsltCompileException

O recurso carregado não é uma folha de estilos válida.

SecurityException

A folha de estilos contém scripts inseridos e o chamador não tem a permissão UnmanagedCode.

Exemplos

O exemplo a seguir transforma um documento XML em um documento HTML. Ele exibe o ISBN, o título e o preço de cada livro em uma tabela.

#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

O exemplo usa os dois arquivos de entrada a seguir.

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>

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl="http://www.w3.org/1999/XSL/Transform"de namespace.

Se a folha de estilos contiver scripts inseridos, o script será compilado em um assembly. O URI da folha de estilos é usado para criar evidências, que são aplicadas ao assembly.

Observação

Aplica-se a

Load(String, XmlResolver)

Carrega a folha de estilos XSLT especificada por uma 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

A URL que especifica a folha de estilos XSLT a ser carregada.

resolver: XmlResolver

O XmlResolver a ser usado para carregar a folha de estilos e qualquer folha de estilos referenciada nos elementos xsl:import e xsl:include.

Se for null, um XmlUrlResolver padrão sem nenhuma credencial de usuário será usado para abrir a folha de estilos. O XmlUrlResolver padrão não é usado para resolver nenhum recurso externo na folha de estilos, de modo que os elementos xsl:import e xsl:include não são resolvidos.

O XmlResolver não é armazenado em cache após o método Load(String, XmlResolver) ser concluído.

Exceções

XsltCompileException

O recurso carregado não é uma folha de estilos válida.

SecurityException

A folha de estilos contém scripts inseridos e o chamador não tem a permissão UnmanagedCode.

Exemplos

O exemplo a seguir transforma um documento XML em um documento HTML. O exemplo carrega uma folha de estilos XSLT que contém um xsl:include elemento que faz referência a outra folha de estilos. Um XmlUrlResolver é passado para o Load método que define as credenciais necessárias para acessar o recurso de rede para a folha de estilos incluída.

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

O exemplo usa os arquivos de dados a seguir 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>

Comentários

Observação

XslTransform dá suporte à sintaxe XSLT 1.0. A folha de estilos XSLT deve incluir a declaração xmlns:xsl= http://www.w3.org/1999/XSL/Transformde namespace.

Se a folha de estilos contiver scripts inseridos, o script será compilado em um assembly. O URI da folha de estilos é usado para criar evidências, que são aplicadas ao assembly.

Observação

Confira também

Aplica-se a

XslTransform.Load Método

Definição

Sobrecargas

Comentários

Load(XPathNavigator, XmlResolver, Evidence)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Load(IXPathNavigable, XmlResolver, Evidence)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Load(XPathNavigator, XmlResolver)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Load(IXPathNavigable, XmlResolver)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Load(XmlReader, XmlResolver)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Load(XmlReader, XmlResolver, Evidence)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Load(XPathNavigator)

Parâmetros

Exceções

Comentários

Aplica-se a

Load(IXPathNavigable)

Parâmetros

Exceções

Comentários

Aplica-se a

Load(XmlReader)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Load(String)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Load(String, XmlResolver)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais