XslCompiledTransform.Transform Methode

Definition

Namespace:: System.Xml.Xsl

Assemblys:: netstandard.dll, System.Xml.ReaderWriter.dll

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.

Führt die XSLT-Transformation aus.

Überlädt

Name	Beschreibung
Transform(XmlReader, XsltArgumentList, TextWriter)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in eine TextWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus IXPathNavigable und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.
Transform(IXPathNavigable, XsltArgumentList, TextWriter)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus IXPathNavigable und gibt die Ergebnisse in eine TextWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.
Transform(IXPathNavigable, XsltArgumentList, Stream)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus IXPathNavigable und gibt die Ergebnisse in einen Datenstrom aus. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.
Transform(XmlReader, XsltArgumentList, XmlWriter)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.
Transform(XmlReader, XsltArgumentList, Stream)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in einen Datenstrom aus. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.
Transform(String, String)	Führt die Transformation mithilfe des durch den URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine Datei aus.
Transform(String, XsltArgumentList, TextWriter)	Führt die Transformation mithilfe des durch den URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine TextWriter.
Transform(String, XsltArgumentList, Stream)	Führt die Transformation mithilfe des vom URI angegebenen Eingabedokuments aus und gibt die Ergebnisse aus, die gestreamt werden sollen. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.
Transform(IXPathNavigable, XmlWriter)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus IXPathNavigable und gibt die Ergebnisse in eine XmlWriter.
Transform(XmlReader, XmlWriter)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in eine XmlWriter.
Transform(String, XmlWriter)	Führt die Transformation mithilfe des vom URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine XmlWriter.
Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)	Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit, und der XmlResolver löst die XSLT-Funktion `document()` auf.
Transform(String, XsltArgumentList, XmlWriter)	Führt die Transformation mithilfe des vom URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)	Führt die Transformation mithilfe des Eingabedokuments aus, das vom IXPathNavigable Objekt angegeben wird, und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit, und die XmlResolver XSLT-Funktion `document()` wird aufgelöst.

Hinweise

Note

Es gibt Unterschiede zwischen XSLT, die im Debugmodus kompiliert wurden, und XSLT, die im Releasemodus kompiliert wurden. In einigen Situationen löst Stylesheets, die im Debugmodus kompiliert wurden, während der Fehler nicht ausLoad, sondern später fehlschlagen.Transform Das im Releasemodus kompilierte Stylesheet schlägt während Loaddes Vorgangs fehl. Ein Beispiel für ein solches Verhalten ist, wenn eine Variable, die nicht vom Knotensatztyp ist, einem Ausdruck zugewiesen wird, in dem ein Knotensatz erforderlich ist.

Transform(XmlReader, XsltArgumentList, TextWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in eine TextWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

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

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

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

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

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

Parameter

input: XmlReader

Ein XmlReader Dokument, das das Eingabedokument enthält.

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: TextWriter

Die TextWriter Ausgabe, für die Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Hinweise

Wenn das Stylesheet eine XSLT-Funktion document() enthält, wird es mithilfe einer XmlUrlResolver ohne Benutzeranmeldeinformationen aufgelöst. Wenn sich die externe Ressource in einer Netzwerkressource befindet, die eine Authentifizierung erfordert, verwenden Sie die Überladung, die als XmlResolver eines der Argumente verwendet wird, und geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen an.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus IXPathNavigable und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

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

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

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

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

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

Parameter

input: IXPathNavigable

Ein Objekt, das die IXPathNavigable Schnittstelle implementiert. Im Microsoft .NET Framework kann dies entweder ein XmlNode (in der Regel ein XmlDocument) oder ein XPathDocument sein, der die zu transformierenden Daten enthält.

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: XmlWriter

Die XmlWriter Ausgabe, für die Sie ausgeben möchten.

Wenn das Stylesheet ein xsl:output Element enthält, sollten Sie das XmlWriter von der XmlWriterSettings Eigenschaft zurückgegebene Objekt erstellenOutputSettings. Dadurch wird sichergestellt, dass die XmlWriter richtigen Ausgabeeinstellungen verfügbar sind.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Hinweise

Wenn die XSLT-Funktion document() aktiviert ist, wird sie mithilfe einer XmlUrlResolver Ohne Benutzeranmeldeinformationen aufgelöst. Wenn sich die externe Ressource in einer Netzwerkressource befindet, die eine Authentifizierung erfordert, verwenden Sie die Überladung, die als XmlResolver eines der Argumente verwendet wird, und geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen an.

Diese Methode unterstützt das xsl:strip-space Element nicht. Wenn das kompilierte Stylesheet das xsl:strip-space Element enthält, müssen Sie die Transform Überladung verwenden, die als XmlReader Eingabeargument verwendet wird.

Die IXPathNavigable-Schnittstelle wird in den Klassen XmlNode und XPathDocument implementiert. Diese Klassen stellen einen Speichercache von XML-Daten dar.

Die XmlNode Klasse basiert auf dem W3C Document Object Model (DOM) und enthält Bearbeitungsfunktionen.
Die XPathDocument Klasse ist ein schreibgeschützter Datenspeicher, der auf dem XPath-Datenmodell basiert. XPathDocument ist die empfohlene Klasse für die XSLT-Verarbeitung. Es bietet eine schnellere Leistung im Vergleich zur XmlNode Klasse.

Transformationen gelten für das Gesamte Dokument. Anders ausgedrückt: Wenn Sie einen anderen Knoten als den Dokumentstammknoten übergeben, verhindert dies nicht, dass der Transformationsprozess auf alle Knoten im geladenen Dokument zugreift. Um ein Knotenfragment zu transformieren, müssen Sie ein Objekt erstellen, das nur das Knotenfragment enthält, und dieses Objekt an die Transform Methode übergeben. Weitere Informationen finden Sie unter How to: Transform a Node Fragment.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus IXPathNavigable und gibt die Ergebnisse in eine TextWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

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

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

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

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

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

Parameter

input: IXPathNavigable

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: TextWriter

Die TextWriter Ausgabe, für die Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Hinweise

Die IXPathNavigable-Schnittstelle wird in den Klassen XmlNode und XPathDocument implementiert. Diese Klassen stellen einen Speichercache von XML-Daten dar.

Die XmlNode Klasse basiert auf dem W3C Document Object Model (DOM) und enthält Bearbeitungsfunktionen.
Die XPathDocument Klasse ist ein schreibgeschützter Datenspeicher, der auf dem XPath-Datenmodell basiert. XPathDocument ist die empfohlene Klasse für die XSLT-Verarbeitung. Es bietet eine schnellere Leistung im Vergleich zur XmlNode Klasse.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(IXPathNavigable, XsltArgumentList, Stream)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus IXPathNavigable und gibt die Ergebnisse in einen Datenstrom aus. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

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

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

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

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

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

Parameter

input: IXPathNavigable

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: Stream

Der Datenstrom, in den Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Beispiele

Im folgenden Beispiel wird eine XSLT-Transformation ausgeführt und in eine 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

Hinweise

Die IXPathNavigable-Schnittstelle wird in den Klassen XmlNode und XPathDocument implementiert. Diese Klassen stellen einen Speichercache von XML-Daten dar.

Die XmlNode Klasse basiert auf dem W3C Document Object Model (DOM) und enthält Bearbeitungsfunktionen.
Die XPathDocument Klasse ist ein schreibgeschützter Datenspeicher, der auf dem XPath-Datenmodell basiert. XPathDocument ist die empfohlene Klasse für die XSLT-Verarbeitung. Es bietet eine schnellere Leistung im Vergleich zur XmlNode Klasse.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(XmlReader, XsltArgumentList, XmlWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

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

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

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

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

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

Parameter

input: XmlReader

Ein XmlReader Dokument, das das Eingabedokument enthält.

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: XmlWriter

Die XmlWriter Ausgabe, für die Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Hinweise

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(XmlReader, XsltArgumentList, Stream)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in einen Datenstrom aus. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

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

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

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

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

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

Parameter

input: XmlReader

Ein XmlReader Dokument, das das Eingabedokument enthält.

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: Stream

Der Datenstrom, in den Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Hinweise

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(String, String)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des durch den URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine Datei aus.

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)

Parameter

inputUri: String

Der URI des Eingabedokuments.

resultsFile: String

Der URI der Ausgabedatei.

Ausnahmen

ArgumentNullException

Der inputUri Wert ist resultsFilenull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

FileNotFoundException

Das Eingabedokument wurde nicht gefunden.

DirectoryNotFoundException

Der inputUri Wert resultsFile enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.

WebException

Der Wert oder inputUri der resultsFile Wert kann nicht aufgelöst werden.

-oder-

Fehler beim Verarbeiten der Anforderung.

UriFormatException

inputUri oder resultsFile ist kein gültiger URI.

XmlException

Fehler beim Analysieren des Eingabedokuments.

Beispiele

Im folgenden Beispiel wird eine Transformation ausgeführt und in eine Datei ausgegeben.

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

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

Diese Methode verwendet einen Standardwert XmlUrlResolver ohne Benutzeranmeldeinformationen, um die Eingabe- und Ausgabedokumente aufzulösen. Wenn sich eine dieser Ressourcen in einer Netzwerkressource befindet, die eine Authentifizierung erfordert, verwenden Sie die Überladung, die als XmlResolver eines ihrer Argumente verwendet wird, und geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen an.

Ein XmlReader Mit Standardeinstellungen wird verwendet, um das Eingabedokument zu laden. DIE DTD-Verarbeitung ist für die XmlReader. Wenn Sie eine DTD-Verarbeitung benötigen, erstellen Sie ein XmlReader Feature mit aktivierter Funktion, und übergeben Sie es an die Transform Methode.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(String, XsltArgumentList, TextWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des durch den URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine TextWriter.

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

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

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

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

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

Parameter

inputUri: String

Der URI des Eingabedokuments.

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: TextWriter

Die TextWriter Ausgabe, für die Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der inputUri Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

DirectoryNotFoundException

Der inputUri Wert enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.

WebException

Der inputUri Wert kann nicht aufgelöst werden.

-oder-

Fehler beim Verarbeiten der Anforderung.

UriFormatException

inputUri ist kein gültiger URI.

XmlException

Fehler beim Analysieren des Eingabedokuments.

Beispiele

Im folgenden Beispiel wird eine XSLT-Transformation ausgeführt und eine Zeichenfolge ausgegeben.

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

Hinweise

Diese Methode verwendet einen Standardwert XmlUrlResolver ohne Benutzeranmeldeinformationen, um das Eingabedokument und alle Instanzen der XSLT-Funktion document() im Stylesheet aufzulösen. Wenn sich eine dieser Ressourcen in einer Netzwerkressource befindet, die eine Authentifizierung erfordert, verwenden Sie die Überladung, die als XmlResolver eines ihrer Argumente verwendet wird, und geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen an.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(String, XsltArgumentList, Stream)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom URI angegebenen Eingabedokuments aus und gibt die Ergebnisse aus, die gestreamt werden sollen. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

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

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

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

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

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

Parameter

inputUri: String

Der URI des Eingabedokuments.

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: Stream

Der Datenstrom, in den Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der inputUri Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

DirectoryNotFoundException

Der inputUri Wert enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.

WebException

Der inputUri Wert kann nicht aufgelöst werden.

-oder-

Fehler beim Verarbeiten der Anforderung.

UriFormatException

inputUri ist kein gültiger URI.

XmlException

Fehler beim Analysieren des Eingabedokuments.

Hinweise

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(IXPathNavigable, XmlWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus IXPathNavigable und gibt die Ergebnisse in eine 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)

Parameter

input: IXPathNavigable

results: XmlWriter

Die XmlWriter Ausgabe, für die Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Beispiele

Im folgenden Beispiel wird eine XSLT-Transformation ausgeführt und an ein XmlWriter Objekt ausgegeben.

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

Hinweise

Die IXPathNavigable-Schnittstelle wird in den Klassen XmlNode und XPathDocument implementiert. Diese Klassen stellen einen Speichercache von XML-Daten dar.

Die XmlNode Klasse basiert auf dem W3C Document Object Model (DOM) und enthält Bearbeitungsfunktionen.
Die XPathDocument Klasse ist ein schreibgeschützter Datenspeicher, der auf dem XPath-Datenmodell basiert. XPathDocument ist die empfohlene Klasse für die XSLT-Verarbeitung. Es bietet eine schnellere Leistung im Vergleich zur XmlNode Klasse.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(XmlReader, XmlWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom Objekt angegebenen Eingabedokuments aus XmlReader und gibt die Ergebnisse in eine 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)

Parameter

input: XmlReader

Das XmlReader enthaltende Eingabedokument.

results: XmlWriter

Die XmlWriter Ausgabe, für die Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Beispiele

Im folgenden Beispiel wird das erste Buch in der datei books.xml transformiert.

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

Hinweise

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(String, XmlWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine 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)

Parameter

inputUri: String

Der URI des Eingabedokuments.

results: XmlWriter

Die XmlWriter Ausgabe, für die Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der inputUri Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

DirectoryNotFoundException

Der inputUri Wert enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.

WebException

Der inputUri Wert kann nicht aufgelöst werden.

-oder-

Fehler beim Verarbeiten der Anforderung.

UriFormatException

inputUri ist kein gültiger URI.

XmlException

Fehler beim Analysieren des Eingabedokuments.

Beispiele

Im folgenden Beispiel wird eine XSLT-Transformation ausgeführt und an ein XmlWriter Objekt ausgegeben.

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

Hinweise

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

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

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

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

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

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

Parameter

input: XmlReader

Ein XmlReader Dokument, das das Eingabedokument enthält.

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: XmlWriter

Die XmlWriter Ausgabe, für die Sie ausgeben möchten.

documentResolver: XmlResolver

Wird XmlResolver verwendet, um die XSLT-Funktion document() aufzulösen. Wenn dies der Fall ist null, wird die document() Funktion nicht aufgelöst.

Ausnahmen

ArgumentNullException

Der input Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

Beispiele

Im folgenden Beispiel wird die XmlSecureResolver XSLT-Funktion document() aufgelöst.

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

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(String, XsltArgumentList, XmlWriter)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des vom URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

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

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

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

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

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

Parameter

inputUri: String

Der URI des Eingabedokuments.

arguments: XsltArgumentList

Eine XsltArgumentList , die die namespacequalifizierten Argumente enthält, die als Eingabe für die Transformation verwendet werden. Dieser Wert kann null sein.

results: XmlWriter

Die XmlWriter Ausgabe, für die Sie ausgeben möchten.

Ausnahmen

ArgumentNullException

Der inputUri Wert ist resultsnull.

XsltException

Fehler beim Ausführen der XSLT-Transformation.

DirectoryNotFoundException

Der inputUri Wert enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.

WebException

Der inputUri Wert kann nicht aufgelöst werden.

-oder-

Fehler beim Verarbeiten der Anforderung.

UriFormatException

inputUri ist kein gültiger URI.

XmlException

Fehler beim Analysieren des Eingabedokuments.

Beispiele

Im folgenden Beispiel wird ein XsltArgumentList Objekt verwendet, um einen Parameter zu erstellen, der das aktuelle Datum und die aktuelle Uhrzeit darstellt.

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

Im Beispiel werden die folgenden beiden Datendateien als Eingabe verwendet.

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>

Hinweise

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Führt die Transformation mithilfe des Eingabedokuments aus, das vom IXPathNavigable Objekt angegeben wird, und gibt die Ergebnisse in eine XmlWriter. Dies XsltArgumentList stellt zusätzliche Laufzeitargumente bereit, und die XmlResolver XSLT-Funktion document() wird aufgelöst.

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

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

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

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

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

Parameter

input: IXPathNavigable

Das Dokument, das durch das IXPathNavigable Objekt angegeben wird.

arguments: XsltArgumentList

Argumentliste als XsltArgumentList.

results: XmlWriter

Die XmlWriter Ausgabe, für die Sie ausgeben möchten.

Wenn das Stylesheet ein xsl:output Element enthält, sollten Sie das XmlWriter objekt XmlWriterSettings erstellen, das von der OutputSettings Eigenschaft zurückgegeben wird. Dadurch wird sichergestellt, dass die XmlWriter richtigen Ausgabeeinstellungen verfügbar sind.

documentResolver: XmlResolver

Wird XmlResolver verwendet, um die XSLT-Funktion document() aufzulösen. Wenn dies der Fall ist null, wird die document() Funktion nicht aufgelöst.

Gilt für:

Feedback

War diese Seite hilfreich?