Entradas para a classe XslCompiledTransform

O Transform método aceita três tipos de entrada para o documento de origem: um objeto que implementa a IXPathNavigable interface, um XmlReader objeto que lê o documento de origem ou um URI de cadeia de caracteres.

Interface de IXPathNavigable

A IXPathNavigable interface é implementada nas classes XmlNode e XPathDocument. Essas classes representam um cache na memória de dados XML.

• A XmlNode classe é baseada no DOM (Modelo de Objeto de Documento) do W3C e inclui recursos de edição.

• A classe de XPathDocument é um repositório de dados somente leitura com base no modelo de dados XPath. XPathDocument é a classe recomendada para processamento XSLT. Ele fornece um desempenho mais rápido quando comparado com a XmlNode classe.

O exemplo a seguir usa o XslCompiledTransform.Transform método para transformar o arquivo books.xml no arquivo books.html usando a folha de estilos transform.xsl. Os arquivos books.xml e transform.xsl podem ser encontrados neste tópico: Como executar uma transformação XSLT usando um assembly.

// Open books.xml as an XPathDocument.
XPathDocument doc = new XPathDocument("books.xml");

// Create a writer for writing the transformed file.
XmlWriter writer = XmlWriter.Create("books.html");

// Create and load the transform with script execution enabled.
XslCompiledTransform transform = new XslCompiledTransform();
XsltSettings settings = new XsltSettings();
settings.EnableScript = true;
transform.Load("transform.xsl", settings, null);

// Execute the transformation.
transform.Transform(doc, writer);

' Open books.xml as an XPathDocument.
Dim doc As XPathDocument = New XPathDocument("books.xml")

' Create a writer for writing the transformed file.
Dim writer As XmlWriter = XmlWriter.Create("books.html")

' Create and load the transform with script execution enabled.
Dim transform As XslCompiledTransform = New XslCompiledTransform()
Dim settings As XsltSettings = New XsltSettings()
settings.EnableScript = True
transform.Load("transform.xsl", settings, Nothing)

'Execute the transformation.
transform.Transform(doc, writer)

Objeto XmlReader

As tanto o método de Transform do nó atual de XmlReader através de todos seus filhos. Isso permite que você use uma parte de um documento como o documento de contexto. Depois que o método de Transform retorna, XmlReader está localizado no nó seguir após ao final do documento de contexto. Se o final do documento for alcançado, o XmlReader será posicionado no final do arquivo (EOF).

O exemplo a seguir usa o XslCompiledTransform.Transform método para transformar o arquivo books.xml no arquivo books.html usando a folha de estilos transform.xsl. Os arquivos books.xml e transform.xsl podem ser encontrados neste tópico: Como executar uma transformação XSLT usando um assembly.

// Create a reader to read books.xml
XmlReader reader = XmlReader.Create("books.xml");

// Create a writer for writing the transformed file.
XmlWriter writer = XmlWriter.Create("books.html");

// Create and load the transform with script execution enabled.
XslCompiledTransform transform = new XslCompiledTransform();
XsltSettings settings = new XsltSettings();
settings.EnableScript = true;
transform.Load("transform.xsl", settings, null);

// Execute the transformation.
transform.Transform(reader, writer);

'Create a reader to read books.xml
Dim reader As XmlReader = XmlReader.Create("books.xml")

' Create a writer for writing the transformed file.
Dim writer As XmlWriter = XmlWriter.Create("books.html")

' Create and load the transform with script execution enabled.
Dim transform As XslCompiledTransform = New XslCompiledTransform()
Dim settings As XsltSettings = New XsltSettings()
settings.EnableScript = True
transform.Load("transform.xsl", settings, Nothing)

' Execute the transformation.
transform.Transform(reader, writer)

URI de cadeia de caracteres

Você também pode especificar o URI do documento de origem como sua entrada XSLT. Um XmlResolver é usado para resolver o URI. Você pode especificar qual XmlResolver usar passando-o para o método Transform. Se um XmlResolver não for especificado, o Transform método usará um padrão XmlUrlResolver sem credenciais.

O exemplo a seguir usa o XslCompiledTransform.Transform método para transformar o arquivo books.xml no arquivo books.html usando a folha de estilos transform.xsl. Os arquivos books.xml e transform.xsl podem ser encontrados neste tópico: Como executar uma transformação XSLT usando um assembly.

// Create and load the transform with script execution enabled.
XslCompiledTransform transform = new XslCompiledTransform();
XsltSettings settings = new XsltSettings();
settings.EnableScript = true;
transform.Load("transform.xsl", settings, null);

// Execute the transformation.
transform.Transform("books.xml", "books.html");

' Create and load the transform with script execution enabled.
Dim transform As XslCompiledTransform = New XslCompiledTransform()
Dim settings As XsltSettings = New XsltSettings()
settings.EnableScript = True
transform.Load("transform.xsl", settings, Nothing)

' Execute the transformation.
transform.Transform("books.xml", "books.html")

Para obter mais informações, consulte Resolvendo recursos externos durante o processamento XSLT.

Consulte também

• Transformações XSLT