Freigeben über

XSLT-Compiler (xsltc.exe)

Der XSLT-Compiler (xsltc.exe) kompiliert XSLT-Stylesheets und generiert eine Assembly. Das kompilierte Stylesheet kann dann direkt an die XslCompiledTransform.Load(Type) Methode übergeben werden. Sie können signierte Assemblys nicht mit xsltc.exegenerieren.

Hinweis

Skriptblöcke werden nur in .NET Framework unterstützt. Sie werden auf .NET Core oder .NET 5 oder höher nicht unterstützt.

Das xsltc.exe-Tool ist in Visual Studio enthalten. Weitere Informationen finden Sie in den Visual Studio-Downloads.

Syntax

xsltc [options] [/class:<name>] <sourceFile> [[/class:<name>] <sourceFile>...]

Streitpunkt

Streitpunkt BESCHREIBUNG
sourceFile Gibt den Namen des Stylesheets an. Das Stylesheet muss eine lokale Datei sein oder sich im Intranet befinden.

Optionen

Auswahlmöglichkeit BESCHREIBUNG
/c[lass]: name Gibt den Namen der Klasse für das folgende Stylesheet an. Der Klassenname kann vollqualifiziert sein.

Der Klassenname ist standardmäßig auf den Namen des Stylesheets festgelegt. Wenn beispielsweise das Stylesheet customers.xsl kompiliert wird, ist der Standardklassenname Kunden.
/debug[+|-] Gibt an, ob Debuginformationen generiert werden sollen.

Durch die Angabe von + oder /debug veranlassen Sie den Compiler, Debuginformationen zu generieren und diese in einer Programmdatenbankdatei (PDB) abzulegen. Der Name der generierten PDB-Datei ist assemblyNamePDB.

Das Angeben von - bewirkt, dass keine Debuginformationen erstellt werden, wenn Sie /debug nicht angeben. Es wird eine Retailassembly generiert. Anmerkung: Das Kompilieren im Debugmodus kann sich erheblich auf die XSLT-Leistung auswirken.
/help Zeigt Befehlssyntax und Optionen für das Tool an.
/nologo Unterdrückt die Anzeige der Compiler-Copyrightmeldung.
/platform: string Gibt die Plattformen an, auf denen die Assembly ausgeführt werden kann. Im Folgenden werden die gültigen Plattformwerte beschrieben:

x86 kompiliert die Assembly, um von der 32-Bit-, x86-kompatiblen Common Language Runtime ausgeführt zu werden.

x64 kompiliert Ihre Assembly so, dass sie von der 64-Bit-Common Language Runtime auf einem Computer ausgeführt wird, der den AMD64- oder EM64T-Befehlssatz unterstützt.

Itanium kompiliert Ihre Assembly, um von der 64-Bit-Common Language Runtime auf einem Computer mit einem Itanium-Prozessor ausgeführt zu werden.

anycpu kompiliert Ihre Assembly, um sie auf einer beliebigen Plattform auszuführen. Dies ist die Standardeinstellung.
/out: assemblyName Gibt den Namen der Assembly an, die ausgegeben wird. Der Assemblyname ist standardmäßig der Name des Hauptstylesheets oder des ersten Stylesheets, wenn mehrere Stylesheets vorhanden sind.

Wenn das Stylesheet Skripts enthält, werden die Skripts in einer separaten Assembly gespeichert. Die Namen der Skriptassemblys werden auf der Grundlage des Namens der Hauptassembly generiert. Wenn Sie z. B. CustOrders.dll für den Assemblynamen angegeben haben, wird die erste Skriptassembly CustOrders_Script1.dllbenannt.
/settings: document+-, script+-, DTD+-, Gibt an, ob document()-Funktionen, XSLT-Skripts oder Dokumenttypdefinitionen (DTD) im Stylesheet zugelassen werden sollen.

Das Standardverhalten deaktiviert die Unterstützung für DTD, die document() Funktion und skripting.
@ file Hiermit können Sie eine Datei angeben, die die Compileroptionen enthält.
? Zeigt Befehlssyntax und Optionen für das Tool an.

Bemerkungen

XSLT-Lösungen können aus mehreren Stylesheetmodulen bestehen. Das xsltc.exe Tool generiert Assemblys aus Stylesheets. Die Assemblys können dann an die XslCompiledTransform.Load(Type) Methode übergeben werden. Dies kann dazu beitragen, die Leistungskosten in einigen XSLT-Bereitstellungsszenarien zu verringern.

Hinweis

Sie müssen die kompilierte Assembly auch als Referenz in Ihre Anwendung einschließen.

Das xsltc.exe Tool überprüft nicht die Namen der Klasse (/class:Name) oder assembly (/out:assemblyName). Fehler werden von der Common Language Runtime ausgelöst, wenn die Namen ungültig sind.

Beispiele

Mit dem folgenden Befehl wird das Stylesheet kompiliert und eine Assembly mit dem Namen booksort.dllerstellt.

xsltc booksort.xsl

Mit dem folgenden Befehl wird das Stylesheet kompiliert und eine Assembly- und PDB-Datei erstellt, die booksort.dll bzw. booksort.pdb genannt wird.

xsltc booksort.xsl /debug

Mit dem folgenden Befehl wird ein Stylesheet kompiliert, das ein msxsl:script Element enthält, und zwei Assemblys mit dem Namen calc.dll und calc_Script1.dllerstellt.

xsltc /settings:script+ calc.xsl

Der folgende Befehl ermöglicht die DTD-Verarbeitung und Skriptunterstützung und erstellt zwei Assemblys mit dem Namen myTest.dll und myTest_Script1.dll.

xsltc /settings:DTD+,script+ /out:myTest calc.xsl

Mit dem folgenden Befehl werden zwei Stylesheetmodule kompiliert und eine einzelne Assembly namens booksort.dllerstellt.

xsltc booksort.xsl output.xsl

Siehe auch