XslCompiledTransform.Transform Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Xml.Xsl

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Esegue la trasformazione XSLT.

Overload

Transform(XmlReader, XsltArgumentList, TextWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e visualizza i risultati in un oggetto TextWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto IXPathNavigable e invia i risultati a un oggetto XmlWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.
Transform(IXPathNavigable, XsltArgumentList, TextWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto IXPathNavigable e invia i risultati a un oggetto TextWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.
Transform(IXPathNavigable, XsltArgumentList, Stream)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto IXPathNavigable e visualizza i risultati in un flusso. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.
Transform(XmlReader, XsltArgumentList, XmlWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e invia i risultati a un oggetto XmlWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.
Transform(XmlReader, XsltArgumentList, Stream)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e visualizza i risultati in un flusso. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.
Transform(String, String)	Esegue la trasformazione usando il documento di input specificato dall'URI e visualizza i risultati in un file.
Transform(String, XsltArgumentList, TextWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'URI e visualizza i risultati in un oggetto TextWriter.
Transform(String, XsltArgumentList, Stream)	Esegue la trasformazione usando il documento di input specificato dall'URI e visualizza i risultati in un flusso. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.
Transform(IXPathNavigable, XmlWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto IXPathNavigable e invia i risultati a un oggetto XmlWriter.
Transform(XmlReader, XmlWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e invia i risultati a un oggetto XmlWriter.
Transform(String, XmlWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'URI e visualizza i risultati in un oggetto XmlWriter.
Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)	Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e invia i risultati a un oggetto XmlWriter. fornisce XsltArgumentList argomenti di runtime aggiuntivi e XmlResolver risolve la funzione XSLT `document()` .
Transform(String, XsltArgumentList, XmlWriter)	Esegue la trasformazione utilizzando il documento di input specificato dall'URI e visualizza i risultati in un oggetto XmlWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)	Esegue la trasformazione usando il documento di input specificato dall'oggetto IXPathNavigable e invia i risultati a un oggetto XmlWriter. L'oggetto XsltArgumentList fornisce argomenti di runtime aggiuntivi, mentre l'oggetto XmlResolver risolve la funzione XSLT `document()`.

Commenti

Nota

Esistono alcune differenze tra il foglio di stile XSLT compilato in modalità debug e il foglio di stile XSLT compilato in modalità di rilascio. In alcune situazioni i fogli di stile compilati in modalità debug non generano errori durante l'operazione Load, ma riporteranno errori successivamente durante l'operazione Transform. Lo stesso foglio di stile compilato in modalità di rilascio avrà esito negativo durante l'operazione Load. Un esempio di tale comportamento si ottiene quando una variabile che non è del tipo set di nodi viene assegnata a un'espressione in cui è richiesto un set di nodi.

Transform(XmlReader, XsltArgumentList, TextWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e visualizza i risultati in un oggetto TextWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);

public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.TextWriter results);

public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);

member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit

Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As TextWriter)

Parametri

input: XmlReader

Oggetto XmlReader contenente il documento di input.

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: TextWriter

Oggetto TextWriter a cui si desidera restituire l'output.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Commenti

Se il foglio di stile include una funzione XSLT document() , viene risolto usando un XmlUrlResolver oggetto senza credenziali utente. Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare l'overload che accetta XmlResolver come uno dei relativi argomenti e specificare un XmlResolver oggetto con le credenziali necessarie.

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto IXPathNavigable e invia i risultati a un oggetto XmlWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit

Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As XmlWriter)

Parametri

input: IXPathNavigable

Oggetto che implementa l'interfaccia IXPathNavigable. In Microsoft .NET Framework può essere un oggetto XmlNode (in genere un oggetto XmlDocument) oppure un oggetto XPathDocument contenente i dati da trasformare.

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: XmlWriter

Oggetto XmlWriter a cui si desidera restituire l'output.

Se il foglio di stile contiene un xsl:output elemento, è necessario creare utilizzando l'oggetto XmlWriter XmlWriterSettings restituito dalla OutputSettings proprietà . In questo modo viene assicurato che le impostazioni di output dell'oggetto XmlWriter siano corrette.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Commenti

Se la funzione XSLT document() è abilitata, viene risolta usando un XmlUrlResolver oggetto senza credenziali utente. Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare l'overload che accetta XmlResolver come uno dei relativi argomenti e specificare un XmlResolver oggetto con le credenziali necessarie.

Questo metodo non supporta l'elemento xsl:strip-space . Se il foglio di stile compilato include l'elemento xsl:strip-space , è necessario utilizzare l'overload Transform che accetta come XmlReader argomento di input.

L'interfaccia IXPathNavigable è implementata nelle classi XmlNode e XPathDocument. Queste classi rappresentano una cache di dati XML in memoria.

La classe XmlNode è basata sul modello DOM (Document Object Model) W3C e include funzionalità di modifica.
La classe XPathDocument è un archivio dati di sola lettura basato sul modello dati XPath. Si consiglia di usare la classe XPathDocument per l'elaborazione di XSLT, in quanto fornisce prestazioni più veloci rispetto alla classe XmlNode.

Le trasformazioni si applicano all'intero documento. In altre parole, se viene passato un nodo diverso dal nodo radice del documento, il processo di trasformazione accederà comunque a tutti i nodi nel documento caricato. Per trasformare un frammento di nodo, è necessario creare un oggetto contenente solo il frammento di nodo e passare tale oggetto al metodo Transform. Per altre informazioni, vedere Procedura: trasformare un frammento di nodo.

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto IXPathNavigable e invia i risultati a un oggetto TextWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.TextWriter results);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit

Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As TextWriter)

Parametri

input: IXPathNavigable

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: TextWriter

Oggetto TextWriter a cui si desidera restituire l'output.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Commenti

Questo metodo non supporta l'elemento xsl:strip-space . Se il foglio di stile compilato includeva l'elemento, è necessario usare l'overload xsl:strip-spaceTransform che accetta come XmlReader argomento di input.

L'interfaccia IXPathNavigable è implementata nelle classi XmlNode e XPathDocument. Queste classi rappresentano una cache di dati XML in memoria.

La classe XmlNode è basata sul modello DOM (Document Object Model) W3C e include funzionalità di modifica.
La classe XPathDocument è un archivio dati di sola lettura basato sul modello dati XPath. Si consiglia di usare la classe XPathDocument per l'elaborazione di XSLT, in quanto fornisce prestazioni più veloci rispetto alla classe XmlNode.

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(IXPathNavigable, XsltArgumentList, Stream)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto IXPathNavigable e visualizza i risultati in un flusso. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.Stream results);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit

Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As Stream)

Parametri

input: IXPathNavigable

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: Stream

Flusso in cui visualizzare il risultato.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Esempio

Nell'esempio seguente viene eseguita una trasformazione XSLT e gli output in un FileStreamoggetto .

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

// Create the FileStream.
using (FileStream fs = new FileStream(@"c:\data\output.xml", FileMode.Create))
{
   // Execute the transformation.
   xslt.Transform(new XPathDocument("books.xml"), null, fs);
}

' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the FileStream.
Using fs As New FileStream("c:\data\output.xml", FileMode.Create)
   ' Execute the transformation.
    xslt.Transform(New XPathDocument("books.xml"), Nothing, fs)
End Using

Commenti

Se la funzione XSLT document() è abilitata, viene risolta usando un oggetto XmlUrlResolver senza credenziali utente. Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare l'overload che accetta come uno degli argomenti e specificare un XmlResolver XmlResolver oggetto con le credenziali necessarie.

L'interfaccia IXPathNavigable è implementata nelle classi XmlNode e XPathDocument. Queste classi rappresentano una cache di dati XML in memoria.

La classe XmlNode è basata sul modello DOM (Document Object Model) W3C e include funzionalità di modifica.
La classe XPathDocument è un archivio dati di sola lettura basato sul modello dati XPath. Si consiglia di usare la classe XPathDocument per l'elaborazione di XSLT, in quanto fornisce prestazioni più veloci rispetto alla classe XmlNode.

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(XmlReader, XsltArgumentList, XmlWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e invia i risultati a un oggetto XmlWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);

public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results);

public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);

member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit

Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As XmlWriter)

Parametri

input: XmlReader

Oggetto XmlReader contenente il documento di input.

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: XmlWriter

Oggetto XmlWriter a cui si desidera restituire l'output.

Se il foglio di stile contiene un xsl:output elemento, è necessario creare l'uso XmlWriter dell'oggetto XmlWriterSettings restituito dalla OutputSettings proprietà . In questo modo viene assicurato che le impostazioni di output dell'oggetto XmlWriter siano corrette.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Commenti

Se il foglio di stile include una funzione XSLT document() , viene risolto usando un oggetto XmlUrlResolver senza credenziali utente. Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare l'overload che accetta come uno degli argomenti e specificare un XmlResolver XmlResolver oggetto con le credenziali necessarie.

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(XmlReader, XsltArgumentList, Stream)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e visualizza i risultati in un flusso. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);

public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.Stream results);

public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);

member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit

Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As Stream)

Parametri

input: XmlReader

Oggetto XmlReader contenente il documento di input.

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: Stream

Flusso in cui visualizzare il risultato.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Commenti

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(String, String)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione usando il documento di input specificato dall'URI e visualizza i risultati in un file.

public:
 void Transform(System::String ^ inputUri, System::String ^ resultsFile);

public void Transform (string inputUri, string resultsFile);

member this.Transform : string * string -> unit

Public Sub Transform (inputUri As String, resultsFile As String)

Parametri

inputUri: String

URI del documento di input.

resultsFile: String

URI del file di output.

Eccezioni

ArgumentNullException

Il valore di inputUri o resultsFile è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

FileNotFoundException

Impossibile trovare il documento di input.

DirectoryNotFoundException

Il valore di inputUri o resultsFile include un nome file o una directory che non è possibile trovare.

WebException

Il valore di inputUri o resultsFile non può essere risolto.

-oppure-

Si è verificato un errore durante l'elaborazione della richiesta.

UriFormatException

inputUri o resultsFile non è un URI valido.

XmlException

Si è verificato un errore di analisi durante il caricamento del documento di input.

Esempio

Nell'esempio seguente viene eseguita una trasformazione e un output in un file.

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

// Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html");

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

L'esempio usa i due file di input seguenti:

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>

Commenti

Questo metodo usa un valore predefinito XmlUrlResolver senza credenziali utente per risolvere i documenti di input e output. Se una di queste risorse si trova in una risorsa di rete che richiede l'autenticazione, usare l'overload che accetta come uno degli argomenti e specificare un XmlResolver XmlResolver oggetto con le credenziali necessarie.

Un XmlReader oggetto con le impostazioni predefinite viene usato per caricare il documento di input. L'elaborazione XmlReaderDTD è disabilitata in . Se è necessaria l'elaborazione Transform DTD, creare un oggetto XmlReader con questa funzionalità abilitata e passarlo al metodo .

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(String, XsltArgumentList, TextWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'URI e visualizza i risultati in un oggetto TextWriter.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);

public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.TextWriter results);

public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);

member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit

Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As TextWriter)

Parametri

inputUri: String

URI del documento di input.

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: TextWriter

Oggetto TextWriter a cui si desidera restituire l'output.

Eccezioni

ArgumentNullException

Il valore di inputUri o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

DirectoryNotFoundException

Il valore di inputUri include un nome file o una directory che non è possibile trovare.

WebException

Il valore di inputUri non può essere risolto.

-oppure-

Si è verificato un errore durante l'elaborazione della richiesta.

UriFormatException

inputUri non è un URI valido.

XmlException

Si è verificato un errore di analisi durante il caricamento del documento di input.

Esempio

Nell'esempio seguente viene eseguita una trasformazione XSLT e viene restituita una stringa.

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

// Transform the file and output an HTML string.
string HTMLoutput;
StringWriter writer = new StringWriter();
xslt.Transform("books.xml", null, writer);
HTMLoutput = writer.ToString();
writer.Close();

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

Commenti

Questo metodo usa un valore predefinito XmlUrlResolver senza credenziali utente per risolvere il documento di input e qualsiasi istanza della funzione XSLT document() trovata nel foglio di stile. Se una di queste risorse si trova in una risorsa di rete che richiede l'autenticazione, usare l'overload che accetta come uno degli argomenti e specificare un XmlResolver XmlResolver oggetto con le credenziali necessarie.

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(String, XsltArgumentList, Stream)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione usando il documento di input specificato dall'URI e visualizza i risultati in un flusso. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);

public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.Stream results);

public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);

member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit

Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As Stream)

Parametri

inputUri: String

URI del documento di input.

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: Stream

Flusso in cui visualizzare il risultato.

Eccezioni

ArgumentNullException

Il valore di inputUri o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

DirectoryNotFoundException

Il valore di inputUri include un nome file o una directory che non è possibile trovare.

WebException

Il valore di inputUri non può essere risolto.

-oppure-

Si è verificato un errore durante l'elaborazione della richiesta.

UriFormatException

inputUri non è un URI valido.

XmlException

Si è verificato un errore di analisi durante il caricamento del documento di input.

Commenti

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(IXPathNavigable, XmlWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto IXPathNavigable e invia i risultati a un oggetto XmlWriter.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::XmlWriter ^ results);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.XmlWriter results);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.XmlWriter -> unit

Public Sub Transform (input As IXPathNavigable, results As XmlWriter)

Parametri

input: IXPathNavigable

results: XmlWriter

Oggetto XmlWriter a cui si desidera restituire l'output.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Esempio

Nell'esempio seguente viene eseguita una trasformazione XSLT e gli output in un XmlWriter oggetto.

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

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

// Execute the transformation.
xslt.Transform(new XPathDocument("books.xml"), writer);
writer.Close();

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

Commenti

L'interfaccia IXPathNavigable è implementata nelle classi XmlNode e XPathDocument. Queste classi rappresentano una cache di dati XML in memoria.

La classe XmlNode è basata sul modello DOM (Document Object Model) W3C e include funzionalità di modifica.
La classe XPathDocument è un archivio dati di sola lettura basato sul modello dati XPath. Si consiglia di usare la classe XPathDocument per l'elaborazione di XSLT, in quanto fornisce prestazioni più veloci rispetto alla classe XmlNode.

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(XmlReader, XmlWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e invia i risultati a un oggetto XmlWriter.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::XmlWriter ^ results);

public void Transform (System.Xml.XmlReader input, System.Xml.XmlWriter results);

member this.Transform : System.Xml.XmlReader * System.Xml.XmlWriter -> unit

Public Sub Transform (input As XmlReader, results As XmlWriter)

Parametri

input: XmlReader

Oggetto XmlReader contenente il documento di input.

results: XmlWriter

Oggetto XmlWriter a cui si desidera restituire l'output.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Esempio

Nell'esempio seguente viene trasformato il primo libro nel file books.xml.

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

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

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

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

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

Commenti

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(String, XmlWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'URI e visualizza i risultati in un oggetto XmlWriter.

public:
 void Transform(System::String ^ inputUri, System::Xml::XmlWriter ^ results);

public void Transform (string inputUri, System.Xml.XmlWriter results);

member this.Transform : string * System.Xml.XmlWriter -> unit

Public Sub Transform (inputUri As String, results As XmlWriter)

Parametri

inputUri: String

URI del documento di input.

results: XmlWriter

Oggetto XmlWriter a cui si desidera restituire l'output.

Eccezioni

ArgumentNullException

Il valore di inputUri o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

DirectoryNotFoundException

Il valore di inputUri include un nome file o una directory che non è possibile trovare.

WebException

Il valore di inputUri non può essere risolto.

-oppure-

Si è verificato un errore durante l'elaborazione della richiesta.

UriFormatException

inputUri non è un URI valido.

XmlException

Si è verificato un errore di analisi durante il caricamento del documento di input.

Esempio

Nell'esempio seguente viene eseguita una trasformazione XSLT e gli output in un XmlWriter oggetto.

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

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

// Execute the transformation.
xslt.Transform("books.xml", writer);
writer.Close();

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

Commenti

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'oggetto XmlReader e invia i risultati a un oggetto XmlWriter. Fornisce XsltArgumentList argomenti di runtime aggiuntivi e XmlResolver risolve la funzione XSLT document() .

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results, System::Xml::XmlResolver ^ documentResolver);

public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver? documentResolver);

public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver documentResolver);

member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter * System.Xml.XmlResolver -> unit

Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As XmlWriter, documentResolver As XmlResolver)

Parametri

input: XmlReader

Oggetto XmlReader contenente il documento di input.

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: XmlWriter

Oggetto XmlWriter a cui si desidera restituire l'output.

documentResolver: XmlResolver

Oggetto XmlResolver usato per la risoluzione della funzione XSLT document(). Se il valore è null, la funzione document() non viene risolta.

Eccezioni

ArgumentNullException

Il valore di input o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

Esempio

Nell'esempio seguente viene usato un XmlSecureResolver oggetto per risolvere la funzione XSLT document() .

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

XsltSettings settings = new XsltSettings();
settings.EnableDocumentFunction = true;

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

// Transform the file.
using (XmlReader reader = XmlReader.Create("books.xml"))
{
   using (XmlWriter writer = XmlWriter.Create("output.xml"))
   {
      xslt.Transform(reader, null, writer, resolver);
   }
}

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

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

        End Using

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(String, XsltArgumentList, XmlWriter)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione utilizzando il documento di input specificato dall'URI e visualizza i risultati in un oggetto XmlWriter. L'oggetto XsltArgumentList fornisce argomenti aggiuntivi in fase di esecuzione.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);

public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results);

public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);

member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit

Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As XmlWriter)

Parametri

inputUri: String

URI del documento di input.

arguments: XsltArgumentList

XsltArgumentList contenente gli argomenti qualificati come spazi dei nomi utilizzati come input della trasformazione. Il valore può essere null.

results: XmlWriter

Oggetto XmlWriter a cui si desidera restituire l'output.

Eccezioni

ArgumentNullException

Il valore di inputUri o results è null.

XsltException

Si è verificato un errore durante l'esecuzione della trasformazione XSLT.

DirectoryNotFoundException

Il valore di inputtUri include un nome file o una directory che non è possibile trovare.

WebException

Il valore di inputUri non può essere risolto.

-oppure-

Si è verificato un errore durante l'elaborazione della richiesta.

UriFormatException

inputUri non è un URI valido.

XmlException

Si è verificato un errore di analisi durante il caricamento del documento di input.

Esempio

Nell'esempio seguente viene usato un oggetto per creare un XsltArgumentList parametro che rappresenta la data e l'ora correnti.

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

public class Sample
{

    public static void Main()
    {

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

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

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

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

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

Public Class Sample

    Public Shared Sub Main()

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

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

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

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

    End Sub
End Class

Nell'esempio vengono usati i due file di dati seguenti come input.

order.xml

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

order.xsl

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

Commenti

Vedi anche

Utilizzo della classe XslCompiledTransform

Si applica a

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Origine:: XslCompiledTransform.cs

Esegue la trasformazione usando il documento di input specificato dall'oggetto IXPathNavigable e invia i risultati a un oggetto XmlWriter. L'oggetto XsltArgumentList fornisce argomenti di runtime aggiuntivi, mentre l'oggetto XmlResolver risolve la funzione XSLT document().

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results, System::Xml::XmlResolver ^ documentResolver);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver? documentResolver);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver documentResolver);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter * System.Xml.XmlResolver -> unit

Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As XmlWriter, documentResolver As XmlResolver)

Parametri

input: IXPathNavigable

Documento da trasformare specificato dall'oggetto IXPathNavigable.

arguments: XsltArgumentList

Elenco di argomenti come XsltArgumentList.

results: XmlWriter

Oggetto XmlWriter a cui si desidera restituire l'output.

Se il foglio di stile contiene un elemento xsl:output, è consigliabile creare l'oggetto XmlWriter tramite l'oggetto XmlWriterSettings restituito dalla proprietà OutputSettings. In questo modo viene assicurato che le impostazioni di output dell'oggetto XmlWriter siano corrette.

documentResolver: XmlResolver

Oggetto XmlResolver usato per la risoluzione della funzione XSLT document(). Se il valore è null, la funzione document() non viene risolta.

Si applica a

Condividi tramite

XslCompiledTransform.Transform Metodo

Definizione

Overload

Commenti

Transform(XmlReader, XsltArgumentList, TextWriter)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Transform(IXPathNavigable, XsltArgumentList, Stream)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Transform(XmlReader, XsltArgumentList, XmlWriter)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Transform(XmlReader, XsltArgumentList, Stream)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Transform(String, String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Transform(String, XsltArgumentList, TextWriter)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Transform(String, XsltArgumentList, Stream)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Transform(IXPathNavigable, XmlWriter)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Transform(XmlReader, XmlWriter)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Transform(String, XmlWriter)

Parametri

Eccezioni

Esempio