XslTransform.Transform Methode

Referenz

Definition

Namespace:: System.Xml.Xsl

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Transformiert die XML-Daten mithilfe des geladenen XSLT-Stylesheets.

Überlädt

Transform(XPathNavigator, XsltArgumentList, XmlResolver)	Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen XmlReader aus.
Transform(XPathNavigator, XsltArgumentList, TextWriter, XmlResolver)	Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen TextWriter aus.
Transform(XPathNavigator, XsltArgumentList, Stream, XmlResolver)	Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen Stream aus.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)	Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen XmlWriter aus.
Transform(IXPathNavigable, XsltArgumentList, TextWriter, XmlResolver)	Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen TextWriter aus.
Transform(IXPathNavigable, XsltArgumentList, Stream, XmlResolver)	Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen Stream aus.
Transform(XPathNavigator, XsltArgumentList, XmlWriter)	Veraltet. Transformiert die XML-Daten im XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlWriter aus.
Transform(XPathNavigator, XsltArgumentList, TextWriter)	Veraltet. Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen TextWriter aus.
Transform(String, String, XmlResolver)	Transformiert die XML-Daten in der Eingabedatei und gibt das Ergebnis in eine Ausgabedatei aus.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter)	Veraltet. Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen XmlWriter aus.
Transform(IXPathNavigable, XsltArgumentList, XmlResolver)	Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen XmlReader aus.
Transform(IXPathNavigable, XsltArgumentList, TextWriter)	Veraltet. Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen TextWriter aus.
Transform(IXPathNavigable, XsltArgumentList, Stream)	Veraltet. Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen Stream aus.
Transform(XPathNavigator, XsltArgumentList, XmlWriter, XmlResolver)	Transformiert die XML-Daten im XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlWriter aus.
Transform(XPathNavigator, XsltArgumentList)	Veraltet. Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen XmlReader aus.
Transform(IXPathNavigable, XsltArgumentList)	Veraltet. Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen XmlReader aus.
Transform(String, String)	Veraltet. Transformiert die XML-Daten in der Eingabedatei und gibt das Ergebnis in eine Ausgabedatei aus.
Transform(XPathNavigator, XsltArgumentList, Stream)	Veraltet. Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen `args` und gibt das Ergebnis an einen Stream aus.

Hinweise

Hinweis

Die XslTransform Klasse ist in der .NET Framework Version 2.0 veraltet. Die XslCompiledTransform Klasse ist der neue XSLT-Prozessor. Weitere Informationen finden Sie unter Verwenden der XslCompiledTransform-Klasse und der Migration von der XslTransform-Klasse.

Transform(XPathNavigator, XsltArgumentList, XmlResolver)

Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlReader aus.

public:
 System::Xml::XmlReader ^ Transform(System::Xml::XPath::XPathNavigator ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::Xml::XmlResolver ^ resolver);

public System.Xml.XmlReader Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList? args, System.Xml.XmlResolver? resolver);

public System.Xml.XmlReader Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.Xml.XmlResolver resolver);

member this.Transform : System.Xml.XPath.XPathNavigator * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlResolver -> System.Xml.XmlReader

Public Function Transform (input As XPathNavigator, args As XsltArgumentList, resolver As XmlResolver) As XmlReader

Parameter

input: XPathNavigator

Ein XPathNavigator, der die zu transformierenden Daten enthält.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform(XPathNavigator, XsltArgumentList, XmlResolver)-Methode nicht zwischengespeichert.

Gibt zurück

XmlReader

Ein XmlReader, der die Ergebnisse der Transformation enthält.

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Die Transformationsauswahl gilt für das Dokument als Ganzes. Wenn der aktuelle Knoten auf einer anderen Knotenstruktur als dem Dokumentstammknoten festgelegt ist, verhindert dies nicht, dass der Transformationsprozess auf alle Knoten im geladenen Dokument zugreift. Nachdem die Transformation durchgeführt wurde, verbleibt der XPathNavigator ursprüngliche Zustand. Dies bedeutet, dass der Knoten, der vor dem Transformationsprozess aktuell ist, weiterhin den aktuellen Knoten bleibt, nachdem die Transform Methode aufgerufen wurde.

Da XmlReader die schreibgeschützte Ausgabe bereitgestellt wird, wird das xsl:output Element ignoriert. Weitere Informationen finden Sie unter "Outputs from an XslTransform ".

Mit dieser Methode können Sie eine asynchrone Transformation des Quelldokuments ausführen.

Siehe auch

Gilt für

Transform(XPathNavigator, XsltArgumentList, TextWriter, XmlResolver)

Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen TextWriter aus.

public:
 void Transform(System::Xml::XPath::XPathNavigator ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::IO::TextWriter ^ output, System::Xml::XmlResolver ^ resolver);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList? args, System.IO.TextWriter output, System.Xml.XmlResolver? resolver);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.IO.TextWriter output, System.Xml.XmlResolver resolver);

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

Public Sub Transform (input As XPathNavigator, args As XsltArgumentList, output As TextWriter, resolver As XmlResolver)

Parameter

input: XPathNavigator

Ein XPathNavigator, der die zu transformierenden Daten enthält.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: TextWriter

Der TextWriter, an den die Ausgabe erfolgen soll.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform(XPathNavigator, XsltArgumentList, TextWriter, XmlResolver)-Methode nicht zwischengespeichert.

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Die Transformationsauswahl gilt für das Dokument als Ganzes. Wenn der aktuelle Knoten auf einem anderen Knoten als dem Dokumentstammknoten festgelegt ist, verhindert dies nicht, dass der Transformationsprozess auf alle Knoten im geladenen Dokument zugreifen kann. Nachdem die Transformation ausgeführt wurde, bleibt der XPathNavigator ursprüngliche Zustand. Dies bedeutet, dass der Knoten, der vor dem Transformationsprozess aktuell ist, den aktuellen Knoten nach dem Aufruf der Transform Methode bleibt.

Das Codierungsattribute für ein Element wird bei der Ausgabe an ein xsl:output TextWriterElement nicht unterstützt. Siehe Ausgabe aus einem XslTransform-Formular für Spezifische, auf denen xsl:output Attribute unterstützt werden.

Siehe auch

Gilt für

Transform(XPathNavigator, XsltArgumentList, Stream, XmlResolver)

Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen Stream aus.

public:
 void Transform(System::Xml::XPath::XPathNavigator ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::IO::Stream ^ output, System::Xml::XmlResolver ^ resolver);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList? args, System.IO.Stream output, System.Xml.XmlResolver? resolver);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.IO.Stream output, System.Xml.XmlResolver resolver);

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

Public Sub Transform (input As XPathNavigator, args As XsltArgumentList, output As Stream, resolver As XmlResolver)

Parameter

input: XPathNavigator

Ein XPathNavigator, der die zu transformierenden Daten enthält.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: Stream

Der Stream, in den ausgegeben werden soll.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform(XPathNavigator, XsltArgumentList, Stream, XmlResolver)-Methode nicht zwischengespeichert.

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Beispiele

Das folgende Beispiel lädt eine Kundentabelle in eine XmlDataDocument und führt eine XSLT-Transformation aus, um die Kundendaten in eine HTML-Tabelle abzurufen. Im Beispiel wird die Microsoft SQL Server 2000 Northwind-Datenbank verwendet.

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

public class Sample
{
  public static void Main()
  {

     // Create a DataSet and load it with customer data.
     DataSet dsNorthwind = new DataSet();
     String sConnect;
     sConnect="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind";
     SqlConnection nwconnect = new SqlConnection(sConnect);
     String sCommand = "Select * from Customers where Region='WA'";
     SqlDataAdapter myDataAdapter = new SqlDataAdapter(sCommand, nwconnect);
     myDataAdapter.Fill(dsNorthwind,"Customers");

     // Load the DataSet into an XmlDataDocument.
     XmlDataDocument doc = new XmlDataDocument(dsNorthwind);

     // Create the XslTransform object and load the stylesheet.
     XslTransform xsl = new XslTransform();
     xsl.Load("customers.xsl");

     // Create an XPathNavigator to use in the transform.
     XPathNavigator nav = doc.CreateNavigator();

     // Create a FileStream object.
     FileStream fs = new FileStream("cust.html", FileMode.Create);

     // Transform the data.
     xsl.Transform(nav, null, fs, null);
  }
}

Imports System.IO
Imports System.Data
Imports System.Data.SqlClient
Imports System.Xml
Imports System.Xml.XPath
Imports System.Xml.Xsl

public class Sample

  public shared sub Main()

     ' Create a DataSet and load it with customer data.
     Dim dsNorthwind as DataSet = new DataSet()        
     Dim sConnect as String           
     sConnect="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind"     
     Dim nwconnect as SqlConnection
     nwconnect = new SqlConnection(sConnect)
     Dim sCommand as String = "Select * from Customers where Region='WA'"
     Dim myDataAdapter as SqlDataAdapter
     myDataAdapter = new SqlDataAdapter(sCommand, nwconnect)
     myDataAdapter.Fill(dsNorthwind,"Customers")

     ' Load the DataSet into an XmlDataDocument.
     Dim doc as XmlDataDocument = new XmlDataDocument(dsNorthwind)   

     ' Create the XslTransform object and load the stylesheet.
     Dim xsl as XslTransform = new XslTransform()     
     xsl.Load("customers.xsl")

     ' Create an XPathNavigator to use in the transform.
     Dim nav as XPathNavigator = doc.CreateNavigator()

     ' Create a FileStream object.
     Dim fs as FileStream = new FileStream("cust.html", FileMode.Create)
 
     ' Transform the data.
     xsl.Transform(nav, nothing, fs, nothing)
    
  end sub
end class

In diesem Beispiel wird die Datei customers.xsl als Eingabe verwendet.

<!-- Stylesheet to sort customers by city-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

  <xsl:template match="NewDataSet">
    <HTML>
      <BODY>
        <TABLE BORDER="2">
          <TR>
            <TD>Company Name</TD>
            <TD>Contact Name</TD>
            <TD>City</TD>
          </TR>
         <xsl:apply-templates select="Customers">
            <xsl:sort select="City"/>
         </xsl:apply-templates>
        </TABLE>
      </BODY>
    </HTML>
  </xsl:template>

  <xsl:template match="Customers">
    <TR>
      <TD><xsl:value-of select="CompanyName"/></TD>
      <TD><xsl:value-of select="ContactName"/></TD>
      <TD><xsl:value-of select="City"/></TD>
    </TR>
  </xsl:template>

</xsl:stylesheet>

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Die Transformationsauswahl gilt für das Dokument als Ganzes. Wenn der aktuelle Knoten auf einem anderen Knoten als dem Dokumentstammknoten festgelegt ist, verhindert dies nicht, dass der Transformationsprozess auf alle Knoten im geladenen Dokument zugreifen kann. Nachdem die Transformation durchgeführt wurde, bleibt der XPathNavigator ursprüngliche Zustand. Dies bedeutet, dass der Knoten, der vor dem Transformationsprozess aktuell ist, den aktuellen Knoten nach dem Aufruf der Transform Methode bleibt.

Siehe Ausgabe aus einem XslTransform-Formular für Spezifische, auf denen xsl:output Attribute unterstützt werden.

Siehe auch

Gilt für

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlWriter aus.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::Xml::XmlWriter ^ output, System::Xml::XmlResolver ^ resolver);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? args, System.Xml.XmlWriter output, System.Xml.XmlResolver? resolver);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args, System.Xml.XmlWriter output, System.Xml.XmlResolver resolver);

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

Public Sub Transform (input As IXPathNavigable, args As XsltArgumentList, output As XmlWriter, resolver As XmlResolver)

Parameter

input: IXPathNavigable

Ein Objekt, das die IXPathNavigable-Schnittstelle implementiert. Dabei kann es sich in .NET Framework entweder um einen XmlNode (in der Regel ein XmlDocument) oder um ein XPathDocument mit den zu transformierenden Daten handeln.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: XmlWriter

Der XmlWriter, an den die Ausgabe erfolgen soll.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)-Methode nicht zwischengespeichert.

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Beispiele

Im folgenden Beispiel wird ein XML-Dokument in ein HTML-Dokument umgewandelt. Sie zeigt die ISBN, den Titel und den Preis für jedes Buch in einer Tabelle an.

#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

In diesem Beispiel werden die folgenden beiden Eingabedateien verwendet:

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>

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Das xsl:output Element wird bei der Ausgabe an ein XmlWriterxsl:output ( wird ignoriert) nicht unterstützt. Weitere Informationen finden Sie unter "Outputs aus einem XslTransform" .

Transformationen werden auf das gesamte Dokument angewendet. Wenn Sie einen anderen Knoten als den Stammknoten des Dokuments übergeben, wird dadurch nicht verhindert, dass im Transformationsprozess auf alle Knoten im geladenen Dokument zugegriffen wird. Um ein Knotenfragment zu transformieren, müssen Sie ein XmlDocument Nur-Knotenfragment erstellen und dies XmlDocument an die Transform Methode übergeben.

Im folgenden Beispiel wird eine Transformation auf einem Knotenfragment ausgeführt.

XslTransform xslt = new XslTransform();       
xslt.Load("print_root.xsl");  
XmlDocument doc = new XmlDocument();  
doc.Load("library.xml");  
// Create a new document containing just the node fragment.  
XmlNode testNode = doc.DocumentElement.FirstChild;   
XmlDocument tmpDoc = new XmlDocument();   
tmpDoc.LoadXml(testNode.OuterXml);  
// Pass the document containing the node fragment   
// to the Transform method.  
Console.WriteLine("Passing " + tmpDoc.OuterXml + " to print_root.xsl");  
xslt.Transform(tmpDoc, null, Console.Out, null);

Im Beispiel werden die und print_root.xsl die library.xml Dateien als Eingabe verwendet und in der Konsole ausgegeben.

Passing <book genre="novel" ISBN="1-861001-57-5"><title>Pride And Prejudice</title></book> to print_root.xsl   
Root node is book.

library.xml

<library>  
  <book genre='novel' ISBN='1-861001-57-5'>  
     <title>Pride And Prejudice</title>  
  </book>  
  <book genre='novel' ISBN='1-81920-21-2'>  
     <title>Hook</title>  
  </book>  
</library>

print_root.xsl

<stylesheet version="1.0" xmlns="http://www.w3.org/1999/XSL/Transform" >  
  <output method="text" />  
  <template match="/">  
  Root node is  <value-of select="local-name(//*[position() = 1])" />   
  </template>  
</stylesheet>

Siehe auch

Gilt für

Transform(IXPathNavigable, XsltArgumentList, TextWriter, XmlResolver)

Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen args und gibt das Ergebnis an einen TextWriter aus.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::IO::TextWriter ^ output, System::Xml::XmlResolver ^ resolver);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? args, System.IO.TextWriter output, System.Xml.XmlResolver? resolver);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args, System.IO.TextWriter output, System.Xml.XmlResolver resolver);

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

Public Sub Transform (input As IXPathNavigable, args As XsltArgumentList, output As TextWriter, resolver As XmlResolver)

Parameter

input: IXPathNavigable

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: TextWriter

Der TextWriter, an den die Ausgabe erfolgen soll.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform(IXPathNavigable, XsltArgumentList, TextWriter, XmlResolver)-Methode nicht zwischengespeichert.

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Beispiele

Im folgenden Beispiel wird eine XML-Datei transformiert und eine HTML-Zeichenfolge ausgegeben. StringWriter Die StringReader Klassen werden verwendet, um die Zeichenfolgen zu lesen und zu schreiben.

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

public class Sample {

  public static void Main() {

    // Create a string containing the XSLT stylesheet.
    String xsltString =
    @"<xsl:stylesheet xmlns:xsl='http://www.w3.org/1999/XSL/Transform' version='1.0'>
        <xsl:template match='bookstore'>
           <HTML>
              <HEAD>
                 <TITLE>Book Titles</TITLE>
             </HEAD>
             <BODY>
                <xsl:apply-templates select='book'/>
             </BODY>
          </HTML>
        </xsl:template>
        <xsl:template match='book'>
          <P><xsl:value-of select='title'/></P>
        </xsl:template>
        </xsl:stylesheet>";

    // Create the XslTransform object.
    XslTransform xslt = new XslTransform();

    // Load the stylesheet.
    StringReader rdr = new StringReader(xsltString);
    xslt.Load(new XPathDocument(rdr), null, null);

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

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

public class Sample 

  public shared sub Main() 
   
    ' Create a string containing the XSLT stylesheet.
    Dim xsltString as String 
    xsltString = "<xsl:stylesheet xmlns:xsl='http://www.w3.org/1999/XSL/Transform' version='1.0'>" & _
    "   <xsl:template match='bookstore'>" & _
    "      <HTML>" & _
    "         <HEAD>" & _
    "            <TITLE>Book Titles</TITLE>" & _
    "       </HEAD>" & _
    "        <BODY>" & _
    "           <xsl:apply-templates select='book'/>" & _
    "        </BODY>" & _
    "     </HTML>" & _
    "   </xsl:template>" & _
    "  <xsl:template match='book'>" & _
    "     <P><xsl:value-of select='title'/></P>" & _
    "   </xsl:template>" & _
    "   </xsl:stylesheet>"

    ' Create the XslTransform object.
    Dim xslt as XslTransform = new XslTransform()

    ' Load the stylesheet.
    Dim rdr as StringReader = new StringReader(xsltString)
    xslt.Load(new XPathDocument(rdr), nothing, nothing)

    ' Transform the file and output an HTML string.
    Dim HTMLoutput as string
    Dim writer as StringWriter = new StringWriter()
    xslt.Transform(new XPathDocument("books.xml"), nothing, writer, nothing)
    HTMLoutput = writer.ToString()

  end sub
end class

In diesem Beispiel wird die Datei books.xml als Eingabe verwendet.

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

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind.

Das Codierungsattribute für ein xsl:output Element wird beim Ausgeben in einem TextWriterElement nicht unterstützt. Informationen zu den unterstützten Attributen xsl:output finden Sie unter "Outputs from an XslTransform".

Transformationen werden auf das gesamte Dokument angewendet. Wenn Sie einen anderen Knoten als den Stammknoten des Dokuments übergeben, wird dadurch nicht verhindert, dass im Transformationsprozess auf alle Knoten im geladenen Dokument zugegriffen wird. Um ein Knotenfragment zu transformieren, müssen Sie nur XmlDocument das Knotenfragment erstellen und dies XmlDocument an die Transform Methode übergeben.

Im folgenden Beispiel wird eine Transformation für ein Knotenfragment ausgeführt.

XslTransform xslt = new XslTransform();       
xslt.Load("print_root.xsl");  
XmlDocument doc = new XmlDocument();  
doc.Load("library.xml");  
// Create a new document containing just the node fragment.  
XmlNode testNode = doc.DocumentElement.FirstChild;   
XmlDocument tmpDoc = new XmlDocument();   
tmpDoc.LoadXml(testNode.OuterXml);  
// Pass the document containing the node fragment   
// to the Transform method.  
Console.WriteLine("Passing " + tmpDoc.OuterXml + " to print_root.xsl");  
xslt.Transform(tmpDoc, null, Console.Out, null);

Im Beispiel werden die library.xml Dateien print_root.xsl als Eingabe verwendet und in der Konsole ausgegeben.

Passing <book genre="novel" ISBN="1-861001-57-5"><title>Pride And Prejudice</title></book> to print_root.xsl   
Root node is book.

library.xml

<library>  
  <book genre='novel' ISBN='1-861001-57-5'>  
     <title>Pride And Prejudice</title>  
  </book>  
  <book genre='novel' ISBN='1-81920-21-2'>  
     <title>Hook</title>  
  </book>  
</library>

print_root.xsl

<stylesheet version="1.0" xmlns="http://www.w3.org/1999/XSL/Transform" >  
  <output method="text" />   
  <template match="/">  
     Root node is  <value-of select="local-name(//*[position() = 1])" />   
  </template>  
</stylesheet>

Siehe auch

Gilt für

Transform(IXPathNavigable, XsltArgumentList, Stream, XmlResolver)

Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen args und gibt das Ergebnis an einen Stream aus.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::IO::Stream ^ output, System::Xml::XmlResolver ^ resolver);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? args, System.IO.Stream output, System.Xml.XmlResolver? resolver);

public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args, System.IO.Stream output, System.Xml.XmlResolver resolver);

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

Public Sub Transform (input As IXPathNavigable, args As XsltArgumentList, output As Stream, resolver As XmlResolver)

Parameter

input: IXPathNavigable

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: Stream

Der Stream, in den ausgegeben werden soll.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform-Methode nicht zwischengespeichert.

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Beispiele

Im folgenden Beispiel wird eine Transformation innerhalb einer ASP.NET Seite ausgeführt.

<%@ Import Namespace="System" %>
<%@ Import Namespace="System.IO" %>
<%@ import NameSpace="System.Web" %>
<%@ Import Namespace="System.Xml.XPath" %>
<%@ Import Namespace="System.Xml.Xsl" %>
<html>
   <script language="C#" runat="server">
      void Page_Load(Object sender, EventArgs e) 
      {
         // Load the XML document to transform.
         XPathDocument doc = new XPathDocument(Server.MapPath("books.xml"));

         // Load the stylesheet and perform the transform.
         XslTransform xslt = new XslTransform();
         xslt.Load(Server.MapPath("output.xsl"));
         xslt.Transform(doc, null, Response.OutputStream, null);
        
      }
   </script>
</html>

<%@ Import Namespace="System" %>
<%@ Import Namespace="System.IO" %>
<%@ import NameSpace="System.Web" %>
<%@ Import Namespace="System.Xml.XPath" %>
<%@ Import Namespace="System.Xml.Xsl" %>
<html>
   <script language="VB" runat="server">
      sub Page_Load(sender as Object, e as EventArgs) 

         ' Load the XML document to transform.
         dim doc as XPathDocument = new XPathDocument(Server.MapPath("books.xml"))

         ' Load the stylesheet and perform the transform.
         dim xslt as XslTransform = new XslTransform()
         xslt.Load(Server.MapPath("output.xsl"))
         xslt.Transform(doc, nothing, Response.OutputStream, nothing)
        
      end sub
   </script>
</html>

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind.

Transformationen werden auf das gesamte Dokument angewendet. Wenn Sie einen anderen Knoten als den Stammknoten des Dokuments übergeben, wird dadurch nicht verhindert, dass im Transformationsprozess auf alle Knoten im geladenen Dokument zugegriffen wird. Um ein Knotenfragment zu transformieren, müssen Sie nur XmlDocument das Knotenfragment erstellen und dies XmlDocument an die Transform Methode übergeben.

Im folgenden Beispiel wird eine Transformation für ein Knotenfragment ausgeführt.

XslTransform xslt = new XslTransform();       
xslt.Load("print_root.xsl");  
XmlDocument doc = new XmlDocument();  
doc.Load("library.xml");  
// Create a new document containing just the node fragment.  
XmlNode testNode = doc.DocumentElement.FirstChild;   
XmlDocument tmpDoc = new XmlDocument();   
tmpDoc.LoadXml(testNode.OuterXml);  
// Pass the document containing the node fragment   
// to the Transform method.  
Console.WriteLine("Passing " + tmpDoc.OuterXml + " to print_root.xsl");  
xslt.Transform(tmpDoc, null, Console.Out, null);

Im Beispiel werden die library.xml Dateien print_root.xsl als Eingabe verwendet und in der Konsole ausgegeben.

Passing <book genre="novel" ISBN="1-861001-57-5"><title>Pride And Prejudice</title></book> to print_root.xsl   
Root node is book.

library.xml

<library>  
  <book genre='novel' ISBN='1-861001-57-5'>  
     <title>Pride And Prejudice</title>  
  </book>  
  <book genre='novel' ISBN='1-81920-21-2'>  
     <title>Hook</title>  
  </book>  
</library>

print_root.xsl

<stylesheet version="1.0" xmlns="http://www.w3.org/1999/XSL/Transform" >  
  <output method="text" />   
  <template match="/">  
     Root node is  <value-of select="local-name(//*[position() = 1])" />   
  </template>  
</stylesheet>

Siehe auch

Gilt für

Transform(XPathNavigator, XsltArgumentList, XmlWriter)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten im XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlWriter aus.

public:
 void Transform(System::Xml::XPath::XPathNavigator ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::Xml::XmlWriter ^ output);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList? args, System.Xml.XmlWriter output);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.Xml.XmlWriter output);

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.Xml.XmlWriter output);

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

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

Public Sub Transform (input As XPathNavigator, args As XsltArgumentList, output As XmlWriter)

Parameter

input: XPathNavigator

Ein XPathNavigator, der die zu transformierenden Daten enthält.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: XmlWriter

Der XmlWriter, an den die Ausgabe erfolgen soll.

Attribute: ObsoleteAttribute

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Die Transformationsauswahl gilt für das Dokument als Ganzes. Wenn der aktuelle Knoten auf einer anderen Knotenstruktur als dem Dokumentstammknoten festgelegt ist, verhindert dies nicht, dass der Transformationsprozess auf alle Knoten im geladenen Dokument zugreift. Nachdem die Transformation ausgeführt wurde, bleibt der XPathNavigator ursprüngliche Zustand erhalten. Dies bedeutet, dass der Knoten, der vor dem Transformationsprozess aktuell ist, den aktuellen Knoten bleibt, nachdem die Transform Methode aufgerufen wurde.

Das xsl:output Element wird beim Ausgeben an ein XmlWriter (xsl:output wird ignoriert) nicht unterstützt. Weitere Informationen finden Sie unter "Outputs from an XslTransform ".

Hinweis

Diese Methode ist veraltet. Die Einstellung der XmlResolver Eigenschaft bestimmt, wie die XSLT-Funktion document() aufgelöst wird. Die empfohlene Methode besteht darin, die Methode zu verwenden, die Transform ein XmlResolver Objekt als eines seiner Argumente verwendet.

Siehe auch

Gilt für

Transform(XPathNavigator, XsltArgumentList, TextWriter)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen TextWriter aus.

public:
 void Transform(System::Xml::XPath::XPathNavigator ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::IO::TextWriter ^ output);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList? args, System.IO.TextWriter output);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.IO.TextWriter output);

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.IO.TextWriter output);

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

[<System.Obsolete("You should pass XmlResolver to Transform() method")>]
member this.Transform : System.Xml.XPath.XPathNavigator * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit

Public Sub Transform (input As XPathNavigator, args As XsltArgumentList, output As TextWriter)

Parameter

input: XPathNavigator

Ein XPathNavigator, der die zu transformierenden Daten enthält.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: TextWriter

Der TextWriter, an den die Ausgabe erfolgen soll.

Attribute: ObsoleteAttribute

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Die Transformationsauswahl gilt für das Dokument als Ganzes. Wenn der aktuelle Knoten auf einer anderen Knotenstruktur als dem Dokumentstammknoten festgelegt ist, verhindert dies nicht, dass der Transformationsprozess auf alle Knoten im geladenen Dokument zugreift. Nachdem die Transformation ausgeführt wurde, bleibt der XPathNavigator ursprüngliche Zustand erhalten. Dies bedeutet, dass der Knoten, der vor dem Transformationsprozess aktuell ist, weiterhin den aktuellen Knoten bleibt, nachdem die Transform Methode aufgerufen wurde.

Hinweis

Siehe auch

Gilt für

Transform(String, String, XmlResolver)

Transformiert die XML-Daten in der Eingabedatei und gibt das Ergebnis in eine Ausgabedatei aus.

public:
 void Transform(System::String ^ inputfile, System::String ^ outputfile, System::Xml::XmlResolver ^ resolver);

public void Transform (string inputfile, string outputfile, System.Xml.XmlResolver? resolver);

public void Transform (string inputfile, string outputfile, System.Xml.XmlResolver resolver);

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

Public Sub Transform (inputfile As String, outputfile As String, resolver As XmlResolver)

Parameter

inputfile: String

Die URL des Quelldokuments, das transformiert werden soll.

outputfile: String

Die URL der Ausgabedatei.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform-Methode nicht zwischengespeichert.

Beispiele

Im folgenden Beispiel wird eine XSLT-Transformation ausgeführt und an eine Datei ausgegeben. Eine XmlUrlResolver Standardanmeldeinformationen wird verwendet, um eine externe Ressource aufzulösen. Einzelheiten dazu finden Sie unter DefaultCredentials.

// Create a resolver with default credentials.
XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
resolver->Credentials = System::Net::CredentialCache::DefaultCredentials;

// Create the XslTransform object.
XslTransform^ xslt = gcnew XslTransform;

// Load the stylesheet.
xslt->Load( "http://myServer/data/authors.xsl", resolver );

// Transform the file.
xslt->Transform( "books.xml", "books.html", resolver );


// Create a resolver with default credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Create the XslTransform object.
XslTransform xslt = new XslTransform();

// Load the stylesheet.
xslt.Load("http://myServer/data/authors.xsl", resolver);

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


' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

' Create the XslTransform object.
Dim xslt as XslTransform = new XslTransform()

' Load the stylesheet.
xslt.Load("http://myServer/data/authors.xsl", resolver)

' Transform the file. 
xslt.Transform("books.xml", "titles.xml", resolver)

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Siehe auch

Gilt für

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlWriter aus.

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

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

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

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args, System.Xml.XmlWriter output);

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

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

Public Sub Transform (input As IXPathNavigable, args As XsltArgumentList, output As XmlWriter)

Parameter

input: IXPathNavigable

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: XmlWriter

Der XmlWriter, an den die Ausgabe erfolgen soll.

Attribute: ObsoleteAttribute

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Hinweis

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Das xsl:output Element wird beim Ausgeben an ein XmlWriter (xsl:output wird ignoriert) nicht unterstützt. Weitere Informationen finden Sie unter "Outputs from an XslTransform ".

Transformationen werden auf das gesamte Dokument angewendet. Wenn Sie einen anderen Knoten als den Stammknoten des Dokuments übergeben, wird dadurch nicht verhindert, dass im Transformationsprozess auf alle Knoten im geladenen Dokument zugegriffen wird. Um ein Knotenfragment zu transformieren, müssen Sie nur XmlDocument das Knotenfragment erstellen und dies XmlDocument an die Transform Methode übergeben.

Im folgenden Beispiel wird eine Transformation für ein Knotenfragment ausgeführt.

XslTransform xslt = new XslTransform();       
xslt.Load("print_root.xsl");  
XmlDocument doc = new XmlDocument();  
doc.Load("library.xml");  
// Create a new document containing just the node fragment.  
XmlNode testNode = doc.DocumentElement.FirstChild;   
XmlDocument tmpDoc = new XmlDocument();   
tmpDoc.LoadXml(testNode.OuterXml);  
// Pass the document containing the node fragment   
// to the Transform method.  
Console.WriteLine("Passing " + tmpDoc.OuterXml + " to print_root.xsl");  
xslt.Transform(tmpDoc, null, Console.Out);

Im Beispiel werden die library.xml Dateien print_root.xsl als Eingabe verwendet und in der Konsole ausgegeben.

Passing <book genre="novel" ISBN="1-861001-57-5"><title>Pride And Prejudice</title></book> to print_root.xsl   
Root node is book.

library.xml

<library>  
  <book genre='novel' ISBN='1-861001-57-5'>  
     <title>Pride And Prejudice</title>  
  </book>  
  <book genre='novel' ISBN='1-81920-21-2'>  
     <title>Hook</title>  
  </book>  
</library>

print_root.xsl

<stylesheet version="1.0" xmlns="http://www.w3.org/1999/XSL/Transform" >  
  <output method="text" />  
  <template match="/">  
  Root node is  <value-of select="local-name(//*[position() = 1])" />   
  </template>  
</stylesheet>

Siehe auch

Gilt für

Transform(IXPathNavigable, XsltArgumentList, XmlResolver)

Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlReader aus.

public:
 System::Xml::XmlReader ^ Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::Xml::XmlResolver ^ resolver);

public System.Xml.XmlReader Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? args, System.Xml.XmlResolver? resolver);

public System.Xml.XmlReader Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args, System.Xml.XmlResolver resolver);

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

Public Function Transform (input As IXPathNavigable, args As XsltArgumentList, resolver As XmlResolver) As XmlReader

Parameter

input: IXPathNavigable

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform(IXPathNavigable, XsltArgumentList, XmlResolver)-Methode nicht zwischengespeichert.

Gibt zurück

XmlReader

Ein XmlReader, der die Ergebnisse der Transformation enthält.

Beispiele

Im folgenden Beispiel wird ein XML-Dokument transformiert und die Ergebnisse in ein XmlReader. Eine XmlUrlResolver mit den erforderlichen Anmeldeinformationen wird verwendet, um alle XSLT-Funktionen document() zu verarbeiten.

// Create the XslTransform object.
XslTransform^ xslt = gcnew XslTransform;

// Load the stylesheet.
xslt->Load( "titles.xsl" );

// Create a resolver and specify the necessary credentials.
XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
System::Net::NetworkCredential^ myCred;
myCred = gcnew System::Net::NetworkCredential( UserName, SecurelyStoredPassword, Domain );
resolver->Credentials = myCred;

// Transform the file using the resolver. The resolver is used
// to process the XSLT document() function.
XPathDocument^ doc = gcnew XPathDocument( "books.xml" );
XmlReader^ reader = xslt->Transform( doc, nullptr, resolver );

// Load the reader into a new document for more processing.
XmlDocument^ xmldoc = gcnew XmlDocument;
xmldoc->Load( reader );

// Create the XslTransform object.
XslTransform xslt = new XslTransform();

// Load the stylesheet.
xslt.Load("titles.xsl");

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

// Transform the file using the resolver. The resolver is used
// to process the XSLT document() function.
XPathDocument doc = new XPathDocument("books.xml");
XmlReader reader = xslt.Transform(doc, null, resolver);

// Load the reader into a new document for more processing.
XmlDocument xmldoc = new XmlDocument();
xmldoc.Load(reader);

' Create the XslTransform object.
Dim xslt as XslTransform = new XslTransform()

' Load the stylesheet.
xslt.Load("titles.xsl")

' Create a resolver and specify the necessary credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
Dim myCred as System.Net.NetworkCredential 
myCred = new System.Net.NetworkCredential(UserName,SecurelyStoredPassword,Domain)
resolver.Credentials = myCred

' Transform thefile using the resolver. The resolver is used
' to process the XSLT document() function.
Dim doc as XPathDocument = new XPathDocument("books.xml")
Dim reader as XmlReader = xslt.Transform(doc, nothing, resolver)

' Load the reader into a new document for more processing.
Dim xmldoc as XmlDocument = new XmlDocument()
xmldoc.Load(reader)

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Das xsl:output Element wird beim Ausgeben an ein XmlReader Element nicht unterstützt (das xsl:output Element wird ignoriert). Weitere Informationen finden Sie unter "Outputs from an XslTransform ".

Mit dieser Methode können Sie eine asynchrone Transformation des Quelldokuments ausführen.

Transformationen werden auf das gesamte Dokument angewendet. Wenn Sie einen anderen Knoten als den Stammknoten des Dokuments übergeben, wird dadurch nicht verhindert, dass im Transformationsprozess auf alle Knoten im geladenen Dokument zugegriffen wird. Um ein Knotenfragment zu transformieren, müssen Sie ein XmlDocument Element erstellen, das nur das Knotenfragment enthält, und dies XmlDocument an die Transform Methode übergeben.

Im folgenden Beispiel wird eine Transformation für ein Knotenfragment ausgeführt.

XslTransform xslt = new XslTransform();       
xslt.Load("print_root.xsl");  
XmlDocument doc = new XmlDocument();  
doc.Load("library.xml");  
// Create a new document containing just the node fragment.  
XmlNode testNode = doc.DocumentElement.FirstChild;   
XmlDocument tmpDoc = new XmlDocument();   
tmpDoc.LoadXml(testNode.OuterXml);  
// Pass the document containing the node fragment   
// to the Transform method.  
Console.WriteLine("Passing " + tmpDoc.OuterXml + " to print_root.xsl");  
xslt.Transform(tmpDoc, null, Console.Out, null);

Im Beispiel werden die library.xml Dateien print_root.xsl als Eingabe verwendet und in der Konsole ausgegeben.

Passing <book genre="novel" ISBN="1-861001-57-5"><title>Pride And Prejudice</title></book> to print_root.xsl   
Root node is book.

library.xml

<library>  
  <book genre='novel' ISBN='1-861001-57-5'>  
     <title>Pride And Prejudice</title>  
  </book>  
  <book genre='novel' ISBN='1-81920-21-2'>  
     <title>Hook</title>  
  </book>  
</library>

print_root.xsl

<stylesheet version="1.0" xmlns="http://www.w3.org/1999/XSL/Transform" >  
  <output method="text" />   
  <template match="/">  
     Root node is  <value-of select="local-name(//*[position() = 1])" />   
  </template>  
</stylesheet>

Siehe auch

Gilt für

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen args und gibt das Ergebnis an einen TextWriter aus.

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

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

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

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args, System.IO.TextWriter output);

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

[<System.Obsolete("You should pass XmlResolver to Transform() method")>]
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit

Public Sub Transform (input As IXPathNavigable, args As XsltArgumentList, output As TextWriter)

Parameter

input: IXPathNavigable

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: TextWriter

Der TextWriter, an den die Ausgabe erfolgen soll.

Attribute: ObsoleteAttribute

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Hinweis

Diese Methode ist veraltet. Die Einstellung der XmlResolver Eigenschaft bestimmt, wie die XSLT-Funktion document() aufgelöst wird. Die empfohlene Vorgehensweise besteht darin, die Methode zu verwenden, die Transform ein Objekt als eines XmlResolver seiner Argumente verwendet.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind.

Transformationen werden auf das gesamte Dokument angewendet. Wenn Sie einen anderen Knoten als den Stammknoten des Dokuments übergeben, wird dadurch nicht verhindert, dass im Transformationsprozess auf alle Knoten im geladenen Dokument zugegriffen wird. Um ein Knotenfragment zu transformieren, müssen Sie ein XmlDocument Element erstellen, das nur das Knotenfragment enthält, und dies XmlDocument an die Transform Methode übergeben.

Im folgenden Beispiel wird eine Transformation für ein Knotenfragment ausgeführt.

XslTransform xslt = new XslTransform();       
xslt.Load("print_root.xsl");  
XmlDocument doc = new XmlDocument();  
doc.Load("library.xml");  
// Create a new document containing just the node fragment.  
XmlNode testNode = doc.DocumentElement.FirstChild;   
XmlDocument tmpDoc = new XmlDocument();   
tmpDoc.LoadXml(testNode.OuterXml);  
// Pass the document containing the node fragment   
// to the Transform method.  
Console.WriteLine("Passing " + tmpDoc.OuterXml + " to print_root.xsl");  
xslt.Transform(tmpDoc, null, Console.Out);

Im Beispiel werden die library.xml Dateien print_root.xsl als Eingabe verwendet und in der Konsole ausgegeben.

Passing <book genre="novel" ISBN="1-861001-57-5"><title>Pride And Prejudice</title></book> to print_root.xsl   
Root node is book.

library.xml

<library>  
  <book genre='novel' ISBN='1-861001-57-5'>  
     <title>Pride And Prejudice</title>  
  </book>  
  <book genre='novel' ISBN='1-81920-21-2'>  
     <title>Hook</title>  
  </book>  
</library>

print_root.xsl

<stylesheet version="1.0" xmlns="http://www.w3.org/1999/XSL/Transform" >  
  <output method="text" />   
  <template match="/">  
     Root node is  <value-of select="local-name(//*[position() = 1])" />   
  </template>  
</stylesheet>

Siehe auch

Gilt für

Transform(IXPathNavigable, XsltArgumentList, Stream)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen args und gibt das Ergebnis an einen Stream aus.

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

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

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

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args, System.IO.Stream output);

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

[<System.Obsolete("You should pass XmlResolver to Transform() method")>]
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit

Public Sub Transform (input As IXPathNavigable, args As XsltArgumentList, output As Stream)

Parameter

input: IXPathNavigable

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: Stream

Der Stream, in den ausgegeben werden soll.

Attribute: ObsoleteAttribute

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Hinweis

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind.

Im folgenden Beispiel wird eine Transformation auf einem Knotenfragment ausgeführt.

XslTransform xslt = new XslTransform();       
xslt.Load("print_root.xsl");  
XmlDocument doc = new XmlDocument();  
doc.Load("library.xml");  
// Create a new document containing just the node fragment.  
XmlNode testNode = doc.DocumentElement.FirstChild;   
XmlDocument tmpDoc = new XmlDocument();   
tmpDoc.LoadXml(testNode.OuterXml);  
// Pass the document containing the node fragment   
// to the Transform method.  
Console.WriteLine("Passing " + tmpDoc.OuterXml + " to print_root.xsl");  
xslt.Transform(tmpDoc, null, Console.Out);

Im Beispiel werden die und print_root.xsl die library.xml Dateien als Eingabe verwendet und in der Konsole ausgegeben.

Passing <book genre="novel" ISBN="1-861001-57-5"><title>Pride And Prejudice</title></book> to print_root.xsl   
Root node is book.

library.xml

<library>  
  <book genre='novel' ISBN='1-861001-57-5'>  
     <title>Pride And Prejudice</title>  
  </book>  
  <book genre='novel' ISBN='1-81920-21-2'>  
     <title>Hook</title>  
  </book>  
</library>

print_root.xsl

<stylesheet version="1.0" xmlns="http://www.w3.org/1999/XSL/Transform" >  
  <output method="text" />   
  <template match="/">  
     Root node is  <value-of select="local-name(//*[position() = 1])" />   
  </template>  
</stylesheet>

Siehe auch

Gilt für

Transform(XPathNavigator, XsltArgumentList, XmlWriter, XmlResolver)

Transformiert die XML-Daten im XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlWriter aus.

public:
 void Transform(System::Xml::XPath::XPathNavigator ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::Xml::XmlWriter ^ output, System::Xml::XmlResolver ^ resolver);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList? args, System.Xml.XmlWriter output, System.Xml.XmlResolver? resolver);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.Xml.XmlWriter output, System.Xml.XmlResolver resolver);

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

Public Sub Transform (input As XPathNavigator, args As XsltArgumentList, output As XmlWriter, resolver As XmlResolver)

Parameter

input: XPathNavigator

Ein XPathNavigator, der die zu transformierenden Daten enthält.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: XmlWriter

Der XmlWriter, an den die Ausgabe erfolgen soll.

resolver: XmlResolver

Der zum Auflösen der XSLT-document()-Funktion verwendete XmlResolver. Wenn dies null ist, wird die document()-Funktion nicht aufgelöst.

Der XmlResolver wird nach Abschluss der Transform(XPathNavigator, XsltArgumentList, XmlWriter, XmlResolver)-Methode nicht zwischengespeichert.

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Beispiele

Im folgenden Beispiel wird ein XML-Dokument geladen und bearbeitet, bevor eine XSLT-Transformation ausgeführt wird.

XmlDocument^ doc = gcnew XmlDocument;
doc->Load( "books.xml" );

// Modify the XML file.
XmlElement^ root = doc->DocumentElement;
root->FirstChild->LastChild->InnerText = "12.95";

// Create an XPathNavigator to use for the transform.
XPathNavigator^ nav = root->CreateNavigator();

// Transform the file.
XslTransform^ xslt = gcnew XslTransform;
xslt->Load( "output.xsl" );
XmlTextWriter^ writer = gcnew XmlTextWriter( "books.html", nullptr );
xslt->Transform( nav, nullptr, writer, nullptr);

XmlDocument doc = new XmlDocument();
doc.Load("books.xml");

// Modify the XML file.
XmlElement root = doc.DocumentElement;
root.FirstChild.LastChild.InnerText = "12.95";

// Create an XPathNavigator to use for the transform.
XPathNavigator nav = root.CreateNavigator();

// Transform the file.
XslTransform xslt = new XslTransform();
xslt.Load("output.xsl");
XmlTextWriter writer = new XmlTextWriter("books.html", null);
xslt.Transform(nav, null, writer, null);

Dim doc as XmlDocument = new XmlDocument()
doc.Load("books.xml")

' Modify the XML file.
Dim root as XmlElement = doc.DocumentElement
root.FirstChild.LastChild.InnerText = "12.95"

' Create an XPathNavigator to use for the transform.
Dim nav as XPathNavigator = root.CreateNavigator()

' Transform the file.
Dim xslt as XslTransform = new XslTransform()
xslt.Load("output.xsl")
Dim writer as XmlTextWriter = new XmlTextWriter("books.html", nothing)
xslt.Transform(nav,nothing, writer, nothing)

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Die Transformationsauswahl gilt für das Dokument als Ganzes. Wenn der aktuelle Knoten auf einem anderen Knoten als dem Dokumentstammknoten festgelegt ist, verhindert dies nicht, dass der Transformationsprozess auf alle Knoten im geladenen Dokument zugreifen kann. Nachdem die Transformation ausgeführt wurde, bleibt der XPathNavigator ursprüngliche Zustand. Dies bedeutet, dass der Knoten, der vor dem Transformationsprozess aktuell ist, den aktuellen Knoten nach dem Aufruf der Transform Methode bleibt.

Das xsl:output Element wird bei der Ausgabe an ein XmlWriterxsl:output ( wird ignoriert) nicht unterstützt. Weitere Informationen finden Sie unter "Outputs aus einem XslTransform" .

Siehe auch

Gilt für

Transform(XPathNavigator, XsltArgumentList)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlReader aus.

public:
 System::Xml::XmlReader ^ Transform(System::Xml::XPath::XPathNavigator ^ input, System::Xml::Xsl::XsltArgumentList ^ args);

public System.Xml.XmlReader Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList? args);

public System.Xml.XmlReader Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args);

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public System.Xml.XmlReader Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args);

member this.Transform : System.Xml.XPath.XPathNavigator * System.Xml.Xsl.XsltArgumentList -> System.Xml.XmlReader

[<System.Obsolete("You should pass XmlResolver to Transform() method")>]
member this.Transform : System.Xml.XPath.XPathNavigator * System.Xml.Xsl.XsltArgumentList -> System.Xml.XmlReader

Public Function Transform (input As XPathNavigator, args As XsltArgumentList) As XmlReader

Parameter

input: XPathNavigator

Ein XPathNavigator, der die zu transformierenden Daten enthält.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

Gibt zurück

XmlReader

Ein XmlReader, der die Ergebnisse der Transformation enthält.

Attribute: ObsoleteAttribute

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Die Transformationsauswahl gilt für das Dokument als Ganzes. Wenn der aktuelle Knoten auf einem anderen Knoten als dem Dokumentstammknoten festgelegt ist, verhindert dies nicht, dass der Transformationsprozess auf alle Knoten im geladenen Dokument zugreifen kann. Nachdem die Transformation durchgeführt wurde, bleibt der XPathNavigator ursprüngliche Zustand. Dies bedeutet, dass der Knoten, der vor dem Transformationsprozess aktuell ist, den aktuellen Knoten nach dem Aufruf der Transform Methode bleibt.

Da XmlReader schreibgeschützte Ausgabe bereitgestellt wird, wird das xsl:output Element ignoriert. Weitere Informationen finden Sie unter "Outputs aus einem XslTransform" .

Mit dieser Methode können Sie eine asynchrone Transformation des Quelldokuments ausführen.

Hinweis

Diese Methode ist veraltet. Die Einstellung der XmlResolver Eigenschaft bestimmt, wie die XSLT-Dokumentfunktion() aufgelöst wird. Die empfohlene Vorgehensweise besteht darin, die Methode zu verwenden, die Transform ein Objekt als eines XmlResolver seiner Argumente verwendet.

Siehe auch

Implementierung von freigegebenen Verhaltensweisen in der XslTransform-Klasse

Gilt für

Transform(IXPathNavigable, XsltArgumentList)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten in IXPathNavigable unter Verwendung der angegebenen args und gibt das Ergebnis an einen XmlReader aus.

public:
 System::Xml::XmlReader ^ Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ args);

public System.Xml.XmlReader Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? args);

public System.Xml.XmlReader Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args);

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public System.Xml.XmlReader Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList args);

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

[<System.Obsolete("You should pass XmlResolver to Transform() method")>]
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList -> System.Xml.XmlReader

Public Function Transform (input As IXPathNavigable, args As XsltArgumentList) As XmlReader

Parameter

input: IXPathNavigable

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

Gibt zurück

XmlReader

Ein XmlReader, der die Ergebnisse der Transformation enthält.

Attribute: ObsoleteAttribute

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Hinweis

Dies args entspricht den elementen, die xsl:param im Stylesheet definiert sind. Das Element wird bei der Ausgabe an ein XmlReader Element nicht unterstützt (das xsl:output xsl:output Element wird ignoriert). Weitere Informationen finden Sie unter "Outputs aus einem XslTransform" .

Mit dieser Methode können Sie eine asynchrone Transformation des Quelldokuments ausführen.

Im folgenden Beispiel wird eine Transformation auf einem Knotenfragment ausgeführt.

XslTransform xslt = new XslTransform();       
xslt.Load("print_root.xsl");  
XmlDocument doc = new XmlDocument();  
doc.Load("library.xml");  
// Create a new document containing just the node fragment.  
XmlNode testNode = doc.DocumentElement.FirstChild;   
XmlDocument tmpDoc = new XmlDocument();   
tmpDoc.LoadXml(testNode.OuterXml);  
// Pass the document containing the node fragment   
// to the Transform method.  
Console.WriteLine("Passing " + tmpDoc.OuterXml + " to print_root.xsl");  
xslt.Transform(tmpDoc, null, Console.Out);

Im Beispiel werden die und print_root.xsl die library.xml Dateien als Eingabe verwendet und in der Konsole ausgegeben.

Passing <book genre="novel" ISBN="1-861001-57-5"><title>Pride And Prejudice</title></book> to print_root.xsl   
Root node is book.

library.xml

<library>  
  <book genre='novel' ISBN='1-861001-57-5'>  
     <title>Pride And Prejudice</title>  
  </book>  
  <book genre='novel' ISBN='1-81920-21-2'>  
     <title>Hook</title>  
  </book>  
</library>

print_root.xsl

<stylesheet version="1.0" xmlns="http://www.w3.org/1999/XSL/Transform" >  
  <output method="text" />   
  <template match="/">  
     Root node is  <value-of select="local-name(//*[position() = 1])" />   
  </template>  
</stylesheet>

Siehe auch

Gilt für

Transform(String, String)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten in der Eingabedatei und gibt das Ergebnis in eine Ausgabedatei aus.

public:
 void Transform(System::String ^ inputfile, System::String ^ outputfile);

public void Transform (string inputfile, string outputfile);

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public void Transform (string inputfile, string outputfile);

member this.Transform : string * string -> unit

[<System.Obsolete("You should pass XmlResolver to Transform() method")>]
member this.Transform : string * string -> unit

Public Sub Transform (inputfile As String, outputfile As String)

Parameter

inputfile: String

Die URL des Quelldokuments, das transformiert werden soll.

outputfile: String

Die URL der Ausgabedatei.

Attribute: ObsoleteAttribute

Beispiele

Im folgenden Beispiel wird die books.xml Datei mithilfe des output.xsl Stylesheets transformiert und die Ergebnisse in die books.html Datei ausgegeben.

// Create the XslTransform object.
XslTransform^ xslt = gcnew XslTransform;

// Load the stylesheet.
xslt->Load( "output.xsl" );

// Transform the file.
xslt->Transform("books.xml","books.html");

//Create the XslTransform object.
XslTransform xslt = new XslTransform();

//Load the stylesheet.
xslt.Load("output.xsl");

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

'Create the XslTransform object.
Dim xslt as XslTransform = new XslTransform()

'Load the stylesheet.
xslt.Load("output.xsl")

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

Im Beispiel werden die folgenden beiden Eingabedateien verwendet:

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>

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Hinweis

Diese Methode ist in Version 1.1 des .NET Framework veraltet. Die Einstellung der XmlResolver Eigenschaft bestimmt, wie die XSLT-Funktion document() aufgelöst wird. Die empfohlene Methode besteht darin, die Methode zu verwenden, die Transform ein XmlResolver Objekt als eines seiner Argumente verwendet.

Siehe auch

Gilt für

Transform(XPathNavigator, XsltArgumentList, Stream)

Achtung

You should pass XmlResolver to Transform() method

Transformiert die XML-Daten in XPathNavigator unter Verwendung der angegebenen args und gibt das Ergebnis an einen Stream aus.

public:
 void Transform(System::Xml::XPath::XPathNavigator ^ input, System::Xml::Xsl::XsltArgumentList ^ args, System::IO::Stream ^ output);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList? args, System.IO.Stream output);

public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.IO.Stream output);

[System.Obsolete("You should pass XmlResolver to Transform() method")]
public void Transform (System.Xml.XPath.XPathNavigator input, System.Xml.Xsl.XsltArgumentList args, System.IO.Stream output);

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

[<System.Obsolete("You should pass XmlResolver to Transform() method")>]
member this.Transform : System.Xml.XPath.XPathNavigator * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit

Public Sub Transform (input As XPathNavigator, args As XsltArgumentList, output As Stream)

Parameter

input: XPathNavigator

Ein XPathNavigator, der die zu transformierenden Daten enthält.

args: XsltArgumentList

Eine XsltArgumentList, die die mit dem Namespace gekennzeichneten Argumente enthält, die als Eingabe für die Transformation verwendet werden.

output: Stream

Der Stream, in den ausgegeben werden soll.

Attribute: ObsoleteAttribute

Ausnahmen

InvalidOperationException

Beim Verarbeiten der XSLT-Transformation ist ein Fehler aufgetreten.

Hinweis: Dies ist eine Änderung im Verhalten gegenüber früheren Versionen. Eine XsltException wird ausgelöst, wenn Sie Microsoft .NET Framework, Version 1.1 oder früher, verwenden.

Hinweise

Hinweis

XslTransform unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss die Namespacedeklaration xmlns:xsl= http://www.w3.org/1999/XSL/Transformenthalten.

Informationen zu den unterstützten Attributen xsl:output finden Sie unter "Outputs from an XslTransform".

Hinweis

Siehe auch

Gilt für