XslCompiledTransform Klasse

Definition

Namespace:
System.Xml.Xsl
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Quelle:
XslCompiledTransform.cs
Quelle:
XslCompiledTransform.cs
Quelle:
XslCompiledTransform.cs
Quelle:
XslCompiledTransform.cs
Quelle:
XslCompiledTransform.cs

Transformiert XML-Daten mithilfe eines XSLT-Stylesheets.

public ref class XslCompiledTransform sealed
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XslCompiledTransform requires dynamic code because it generates IL at runtime.")]
public sealed class XslCompiledTransform
public sealed class XslCompiledTransform
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("XslCompiledTransform requires dynamic code because it generates IL at runtime.")>]
type XslCompiledTransform = class
type XslCompiledTransform = class
Public NotInheritable Class XslCompiledTransform
Vererbung
Object
XslCompiledTransform
Attribute
RequiresDynamicCodeAttribute

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:

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

<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

Weitere Informationen zu dieser API finden Sie in den ergänzenden API-Hinweisen für XslCompiledTransform.

Konstruktoren

Name Beschreibung
XslCompiledTransform()

Initialisiert eine neue Instanz der XslCompiledTransform-Klasse.
XslCompiledTransform(Boolean)

Initialisiert eine neue Instanz der XslCompiledTransform Klasse mit der angegebenen Debugeinstellung.

Eigenschaften

Name Beschreibung
OutputSettings

Ruft ein XmlWriterSettings Objekt ab, das die Ausgabeinformationen enthält, die xsl:output vom Element des Stylesheets abgeleitet sind.
TemporaryFiles

Ruft die, die TempFileCollection die temporären Dateien enthält, die auf dem Datenträger nach einem erfolgreichen Aufruf der Load Methode generiert werden.

Methoden

Name Beschreibung
CompileToType(XmlReader, XsltSettings, XmlResolver, Boolean, TypeBuilder, String)

Kompiliert ein XSLT-Stylesheet zu einem angegebenen Typ.
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
Load(IXPathNavigable, XsltSettings, XmlResolver)

Kompiliert das XSLT-Stylesheet, das in der IXPathNavigableDatei enthalten ist. Die XmlResolver Auflösungen von XSLT import oder include Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(IXPathNavigable)

Kompiliert das im IXPathNavigable Objekt enthaltene Stylesheet.
Load(MethodInfo, Byte[], Type[])

Lädt eine Methode aus einem stylesheet, das mithilfe des XSLTC.exe Hilfsprogramms kompiliert wurde.
Load(String, XsltSettings, XmlResolver)

Lädt und kompiliert das durch den URI angegebene XSLT-Stylesheet. Die XmlResolver Auflösungen von XSLT import oder include Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(String)

Lädt und kompiliert das Stylesheet, das sich am angegebenen URI befindet.
Load(Type)

Lädt das kompilierte Stylesheet, das mit dem XSLT-Compiler (xsltc.exe) erstellt wurde.
Load(XmlReader, XsltSettings, XmlResolver)

Kompiliert das XSLT-Stylesheet, das in der XmlReaderDatei enthalten ist. Die XmlResolver Auflösungen von XSLT import oder include Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(XmlReader)

Kompiliert das in der XmlReaderDatei enthaltene Stylesheet.
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
Transform(IXPathNavigable, XmlWriter)

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

Führt die Transformation mithilfe des durch den URI angegebenen Eingabedokuments aus und gibt die Ergebnisse in eine Datei aus.
Transform(String, XmlWriter)

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

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

Gilt für:

Threadsicherheit

Das XslCompiledTransform Objekt ist threadsicher, sobald es geladen wurde. Anders ausgedrückt: Nachdem die Load Methode erfolgreich abgeschlossen wurde, kann die Transform Methode von mehreren Threads gleichzeitig aufgerufen werden.

Wenn die Load Methode in einem Thread erneut aufgerufen wird, während die Transform Methode in einem anderen Thread aufgerufen wird, beendet das Objekt die XslCompiledTransform Ausführung des Transform Aufrufs, indem er den alten Zustand weiter verwendet. Der neue Zustand wird verwendet, wenn die Load Methode erfolgreich abgeschlossen wurde.

Die Load Methode ist nicht threadsicher, wenn sie gleichzeitig von mehreren Threads aufgerufen wird.

Weitere Informationen