XslCompiledTransform.Transform Methode

Definitie

Naamruimte:: System.Xml.Xsl

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt de XSLT-transformatie uitgevoerd.

Overloads

Name	Description
Transform(XmlReader, XsltArgumentList, TextWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een TextWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een XmlWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.
Transform(IXPathNavigable, XsltArgumentList, TextWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een TextWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.
Transform(IXPathNavigable, XsltArgumentList, Stream)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een stream. De XsltArgumentList functie bevat aanvullende runtime-argumenten.
Transform(XmlReader, XsltArgumentList, XmlWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een XmlWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.
Transform(XmlReader, XsltArgumentList, Stream)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een stream. De XsltArgumentList functie bevat aanvullende runtime-argumenten.
Transform(String, String)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit naar een bestand.
Transform(String, XsltArgumentList, TextWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit naar een TextWriter.
Transform(String, XsltArgumentList, Stream)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit die moeten worden gestreamd. De XsltArgumentList functie bevat aanvullende runtime-argumenten.
Transform(IXPathNavigable, XmlWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een XmlWriter.
Transform(XmlReader, XmlWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een XmlWriter.
Transform(String, XmlWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit naar een XmlWriter.
Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een XmlWriter. De XsltArgumentList functie biedt extra runtime-argumenten en de XmlResolver lost de XSLT-functie `document()` op.
Transform(String, XsltArgumentList, XmlWriter)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit naar een XmlWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)	Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een XmlWriter. De XsltArgumentList functie biedt extra runtime-argumenten en de XmlResolver functie XSLT `document()` wordt omgezet.

Opmerkingen

Note

Er zijn verschillen tussen XSLT gecompileerd in de foutopsporingsmodus en XSLT gecompileerd in de releasemodus. In sommige situaties veroorzaken opmaakmodellen die zijn gecompileerd in de foutopsporingsmodus geen fouten tijdens Load, maar mislukken ze later tijdens Transform. Hetzelfde opmaakmodel dat in de releasemodus is gecompileerd, mislukt tijdens Load. Een voorbeeld van dergelijk gedrag is wanneer een variabele die niet van een type knooppuntset is toegewezen aan een expressie waarin een knooppuntset is vereist.

Transform(XmlReader, XsltArgumentList, TextWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een TextWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.

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)

Parameters

input: XmlReader

Een XmlReader met het invoerdocument.

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: TextWriter

De TextWriter uitvoer waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Opmerkingen

Als het opmaakmodel een XSLT-functie document() bevat, wordt deze opgelost met behulp van een XmlUrlResolver zonder gebruikersreferenties. Als de externe resource zich op een netwerkresource bevindt waarvoor verificatie is vereist, gebruikt u de overbelasting die een XmlResolver van de argumenten gebruikt en geeft u een XmlResolver met de benodigde referenties op.

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een XmlWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.

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)

Parameters

input: IXPathNavigable

Een object dat de IXPathNavigable interface implementeert. In het Microsoft .NET Framework kan dit een XmlNode (meestal een XmlDocument) of een XPathDocument met de gegevens die moeten worden getransformeerd.

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: XmlWriter

De XmlWriter uitvoer waarnaar u wilt uitvoeren.

Als het opmaakmodel een xsl:output element bevat, moet u het XmlWriter object maken dat XmlWriterSettings wordt geretourneerd door de OutputSettings eigenschap. Dit zorgt ervoor dat de XmlWriter juiste uitvoerinstellingen zijn.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Opmerkingen

Als de XSLT-functie document() is ingeschakeld, wordt deze opgelost met behulp van een XmlUrlResolver zonder gebruikersreferenties. Als de externe resource zich op een netwerkresource bevindt waarvoor verificatie is vereist, gebruikt u de overbelasting die een XmlResolver van de argumenten gebruikt en geeft u een XmlResolver met de benodigde referenties op.

Deze methode biedt geen ondersteuning voor het xsl:strip-space element. Als het gecompileerde opmaakmodel het xsl:strip-space element bevat, moet u de Transform overbelasting gebruiken die een XmlReader invoerargument gebruikt.

De IXPathNavigable interface wordt geïmplementeerd in de XmlNode en XPathDocument klassen. Deze klassen vertegenwoordigen een cache in het geheugen van XML-gegevens.

De XmlNode klasse is gebaseerd op de W3C Document Object Model (DOM) en bevat bewerkingsmogelijkheden.
De XPathDocument klasse is een alleen-lezen gegevensarchief op basis van het XPath-gegevensmodel. XPathDocument is de aanbevolen klasse voor XSLT-verwerking. Het biedt snellere prestaties in vergelijking met de XmlNode klasse.

Transformaties zijn van toepassing op het document als geheel. Met andere woorden, als u een ander knooppunt dan het hoofdknooppunt van het document doorgeeft, voorkomt dit niet dat het transformatieproces toegang heeft tot alle knooppunten in het geladen document. Als u een knooppuntfragment wilt transformeren, moet u een object maken dat alleen het knooppuntfragment bevat en dat object doorgeeft aan de Transform methode. Zie Procedure: Een knooppuntfragment transformeren voor meer informatie.

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een TextWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.

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)

Parameters

input: IXPathNavigable

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: TextWriter

De TextWriter uitvoer waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Opmerkingen

De IXPathNavigable interface wordt geïmplementeerd in de XmlNode en XPathDocument klassen. Deze klassen vertegenwoordigen een cache in het geheugen van XML-gegevens.

De XmlNode klasse is gebaseerd op de W3C Document Object Model (DOM) en bevat bewerkingsmogelijkheden.
De XPathDocument klasse is een alleen-lezen gegevensarchief op basis van het XPath-gegevensmodel. XPathDocument is de aanbevolen klasse voor XSLT-verwerking. Het biedt snellere prestaties in vergelijking met de XmlNode klasse.

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(IXPathNavigable, XsltArgumentList, Stream)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een stream. De XsltArgumentList functie bevat aanvullende runtime-argumenten.

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)

Parameters

input: IXPathNavigable

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: Stream

De stroom waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Voorbeelden

In het volgende voorbeeld wordt een XSLT-transformatie en uitvoer uitgevoerd naar een FileStream.

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

Opmerkingen

De IXPathNavigable interface wordt geïmplementeerd in de XmlNode en XPathDocument klassen. Deze klassen vertegenwoordigen een cache in het geheugen van XML-gegevens.

De XmlNode klasse is gebaseerd op de W3C Document Object Model (DOM) en bevat bewerkingsmogelijkheden.
De XPathDocument klasse is een alleen-lezen gegevensarchief op basis van het XPath-gegevensmodel. XPathDocument is de aanbevolen klasse voor XSLT-verwerking. Het biedt snellere prestaties in vergelijking met de XmlNode klasse.

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(XmlReader, XsltArgumentList, XmlWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een XmlWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.

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)

Parameters

input: XmlReader

Een XmlReader met het invoerdocument.

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: XmlWriter

De XmlWriter uitvoer waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Opmerkingen

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(XmlReader, XsltArgumentList, Stream)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een stream. De XsltArgumentList functie bevat aanvullende runtime-argumenten.

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)

Parameters

input: XmlReader

Een XmlReader met het invoerdocument.

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: Stream

De stroom waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Opmerkingen

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(String, String)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit naar een bestand.

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)

Parameters

inputUri: String

De URI van het invoerdocument.

resultsFile: String

De URI van het uitvoerbestand.

Uitzonderingen

ArgumentNullException

De inputUri waarde of resultsFile de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

FileNotFoundException

Kan het invoerdocument niet vinden.

DirectoryNotFoundException

De inputUri of resultsFile waarde bevat een bestandsnaam of map kan niet worden gevonden.

WebException

De inputUri waarde of resultsFile de waarde kan niet worden omgezet.

– of –

Er is een fout opgetreden tijdens het verwerken van de aanvraag.

UriFormatException

inputUri of resultsFile is geen geldige URI.

XmlException

Er is een parseringsfout opgetreden bij het laden van het invoerdocument.

Voorbeelden

In het volgende voorbeeld wordt een transformatie en uitvoer uitgevoerd naar een bestand.

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

In het voorbeeld worden de volgende twee invoerbestanden gebruikt:

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>

Opmerkingen

Deze methode maakt gebruik van een standaard XmlUrlResolver zonder gebruikersreferenties om de invoer- en uitvoerdocumenten op te lossen. Als een van deze resources zich in een netwerkresource bevindt waarvoor verificatie is vereist, gebruikt u de overbelasting die een XmlResolver van de argumenten gebruikt en geeft u een XmlResolver met de benodigde referenties op.

Een XmlReader met standaardinstellingen wordt gebruikt om het invoerdocument te laden. DTD-verwerking is uitgeschakeld op de XmlReader. Als u DTD-verwerking nodig hebt, maakt u een XmlReader functie waarvoor deze functie is ingeschakeld en geeft u deze door aan de Transform methode.

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(String, XsltArgumentList, TextWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit naar een 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);

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

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

Parameters

inputUri: String

De URI van het invoerdocument.

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: TextWriter

De TextWriter uitvoer waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De inputUri waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

DirectoryNotFoundException

De inputUri waarde bevat een bestandsnaam of map die niet kan worden gevonden.

WebException

De inputUri waarde kan niet worden omgezet.

– of –

Er is een fout opgetreden tijdens het verwerken van de aanvraag.

UriFormatException

inputUri is geen geldige URI.

XmlException

Er is een parseringsfout opgetreden bij het laden van het invoerdocument.

Voorbeelden

In het volgende voorbeeld wordt een XSLT-transformatie uitgevoerd en wordt een tekenreeks uitgevoerd.

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

Opmerkingen

Deze methode maakt gebruik van een standaard XmlUrlResolver zonder gebruikersreferenties om het invoerdocument en eventuele exemplaren van de XSLT-functie document() in het opmaakmodel op te lossen. Als een van deze resources zich in een netwerkresource bevindt waarvoor verificatie is vereist, gebruikt u de overbelasting die een XmlResolver van de argumenten gebruikt en geeft u een XmlResolver met de benodigde referenties op.

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(String, XsltArgumentList, Stream)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit die moeten worden gestreamd. De XsltArgumentList functie bevat aanvullende runtime-argumenten.

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

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

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

Parameters

inputUri: String

De URI van het invoerdocument.

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: Stream

De stroom waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De inputUri waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

DirectoryNotFoundException

De inputUri waarde bevat een bestandsnaam of map die niet kan worden gevonden.

WebException

De inputUri waarde kan niet worden omgezet.

– of –

Er is een fout opgetreden tijdens het verwerken van de aanvraag.

UriFormatException

inputUri is geen geldige URI.

XmlException

Er is een parseringsfout opgetreden bij het laden van het invoerdocument.

Opmerkingen

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(IXPathNavigable, XmlWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het IXPathNavigable object en voert de resultaten uit naar een 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)

Parameters

input: IXPathNavigable

results: XmlWriter

De XmlWriter uitvoer waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Voorbeelden

In het volgende voorbeeld wordt een XSLT-transformatie en uitvoer uitgevoerd naar een XmlWriter object.

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

Opmerkingen

De IXPathNavigable interface wordt geïmplementeerd in de XmlNode en XPathDocument klassen. Deze klassen vertegenwoordigen een cache in het geheugen van XML-gegevens.

De XmlNode klasse is gebaseerd op de W3C Document Object Model (DOM) en bevat bewerkingsmogelijkheden.
De XPathDocument klasse is een alleen-lezen gegevensarchief op basis van het XPath-gegevensmodel. XPathDocument is de aanbevolen klasse voor XSLT-verwerking. Het biedt snellere prestaties in vergelijking met de XmlNode klasse.

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(XmlReader, XmlWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door het XmlReader object en voert de resultaten uit naar een 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)

Parameters

input: XmlReader

Het XmlReader bestand met het invoerdocument.

results: XmlWriter

De XmlWriter uitvoer waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Voorbeelden

In het volgende voorbeeld wordt het eerste boek in het bestand books.xml getransformeerd.

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

Opmerkingen

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(String, XmlWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit naar een 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)

Parameters

inputUri: String

De URI van het invoerdocument.

results: XmlWriter

De XmlWriter uitvoer waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De inputUri waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

DirectoryNotFoundException

De inputUri waarde bevat een bestandsnaam of map die niet kan worden gevonden.

WebException

De inputUri waarde kan niet worden omgezet.

– of –

Er is een fout opgetreden tijdens het verwerken van de aanvraag.

UriFormatException

inputUri is geen geldige URI.

XmlException

Er is een parseringsfout opgetreden bij het laden van het invoerdocument.

Voorbeelden

In het volgende voorbeeld wordt een XSLT-transformatie en uitvoer uitgevoerd naar een XmlWriter object.

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

Opmerkingen

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

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)

Parameters

input: XmlReader

Een XmlReader met het invoerdocument.

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: XmlWriter

De XmlWriter uitvoer waarnaar u wilt uitvoeren.

documentResolver: XmlResolver

De XmlResolver functie die wordt gebruikt om de XSLT-functie document() op te lossen. Als dit het probleem is null, wordt de document() functie niet opgelost.

Uitzonderingen

ArgumentNullException

De input waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

Voorbeelden

In het volgende voorbeeld wordt een XmlSecureResolver functie gebruikt om de XSLT-functie document() op te lossen.

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

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(String, XsltArgumentList, XmlWriter)

Voert de transformatie uit met behulp van het invoerdocument dat is opgegeven door de URI en voert de resultaten uit naar een XmlWriter. De XsltArgumentList functie bevat aanvullende runtime-argumenten.

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

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

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

Parameters

inputUri: String

De URI van het invoerdocument.

arguments: XsltArgumentList

Een XsltArgumentList met de naamruimte gekwalificeerde argumenten die worden gebruikt als invoer voor de transformatie. Deze waarde kan zijn null.

results: XmlWriter

De XmlWriter uitvoer waarnaar u wilt uitvoeren.

Uitzonderingen

ArgumentNullException

De inputUri waarde of results de waarde is null.

XsltException

Er is een fout opgetreden bij het uitvoeren van de XSLT-transformatie.

DirectoryNotFoundException

De inputUri waarde bevat een bestandsnaam of map die niet kan worden gevonden.

WebException

De inputUri waarde kan niet worden omgezet.

– of –

Er is een fout opgetreden tijdens het verwerken van de aanvraag.

UriFormatException

inputUri is geen geldige URI.

XmlException

Er is een parseringsfout opgetreden bij het laden van het invoerdocument.

Voorbeelden

In het volgende voorbeeld wordt een XsltArgumentList object gebruikt om een parameter te maken die de huidige datum en tijd vertegenwoordigt.

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

In het voorbeeld worden de volgende twee gegevensbestanden als invoer gebruikt.

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>

Opmerkingen

Zie ook

De klasse XslCompiledTransform gebruiken

Van toepassing op

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

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)

Parameters

input: IXPathNavigable

Het document dat moet worden getransformeerd dat is opgegeven door het IXPathNavigable object.

arguments: XsltArgumentList

Lijst met argumenten als XsltArgumentList.

results: XmlWriter

De XmlWriter uitvoer waarnaar u wilt uitvoeren.

Als het opmaakmodel een xsl:output element bevat, moet u het XmlWriter maken met behulp van het XmlWriterSettings object dat wordt geretourneerd vanuit de OutputSettings eigenschap. Dit zorgt ervoor dat de XmlWriter juiste uitvoerinstellingen zijn.

documentResolver: XmlResolver

De XmlResolver functie die wordt gebruikt om de XSLT-functie document() op te lossen. Als dit het probleem is null, wordt de document() functie niet opgelost.

Van toepassing op

Feedback

Is deze pagina nuttig?