XSLT-Compiler (xsltc.exe)

  • Artikel

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

Hinweis

Skriptblöcke werden nur im .NET Framework unterstützt. In .NET Core oder .NET 5 oder höher werden sie nicht unterstützt.

Das Tool „xsltc.exe“ ist Bestandteil von Visual Studio. Weitere Informationen finden Sie bei den Visual Studio-Downloads.

Syntax

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

Argument

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

Optionen

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

In der Standardeinstellung ist der Klassenname mit dem Namen des Stylesheets identisch. Wenn zum Beispiel das Stylesheet customers.xsl kompiliert wird, lautet der standardmäßige Klassenname customers.
/debug[+|-] Gibt an, ob Debuginformationen generiert werden sollen.

Wenn + oder /debug angegeben wird, generiert der Compiler Debuginformationen und speichert sie in einer Programmdatenbankdatei (PDB-Datei). Der Name der generierten PDB-Datei lautet assemblyName.pdb.

Wenn Sie - angeben, der in Kraft ist, wenn Sie /debug nicht angeben, werden keine Debuginformationen erstellt. Es wird eine Retailassembly generiert. Hinweis: Beim Kompilieren im Debugmodus kann sich die XSLT-Leistung spürbar verringern.
/help Zeigt Befehlssyntax und Optionen für das Tool an.
/nologo Unterdrückt die Anzeige der Compilercopyrightmeldung.
/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 für die 32-Bit-x86-kompatible CLR (Common Language Runtime).

x64 kompiliert die Assembly für die 64-Bit-CLR auf einem Computer, der den AMD64- oder EM64T-Anweisungssatz unterstützt.

Itanium kompiliert die Assembly für die 64-Bit-CLR auf einem Computer mit einem Itanium-Prozessor.

anycpu kompiliert die Assembly für die Ausführung auf einer beliebigen Plattform. Dies ist die Standardeinstellung.
/out: assemblyName Gibt den Namen der Assembly an, die ausgegeben wird. Der Assemblyname entspricht standardmäßig dem Namen des Hauptstylesheets bzw. des ersten Stylesheets, falls es mehrere Stylesheets gibt.

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. als Assemblynamen CustOrders.dll angegeben haben, wird die erste Skriptassembly CustOrders_Script1.dll genannt.
/settings: document+-, script+-, DTD+-, Gibt an, ob document()-Funktionen, XSLT-Skripts oder Dokumenttypdefinitionen (DTD) im Stylesheet zugelassen sind.

In der Standardeinstellung werden DTD, die document()-Funktion und Skripts nicht unterstützt.
@ file Ermöglicht die Angabe einer Datei, die Compileroptionen enthält.
? Zeigt Befehlssyntax und Optionen für das Tool an.

Hinweise

XSLT-Lösungen können aus mehreren Stylesheetmodulen bestehen. Das Tool <legacyBold>xsltc.exe</legacyBold> generiert Assemblys auf der Grundlage von Stylesheets. Die Assemblys können dann direkt in die XslCompiledTransform.Load(Type)-Methode übergeben werden. Auf diese Weise lassen sich in einigen XSLT-Bereitstellungsszenarios die zu verzeichnenden Leistungseinbußen verringern.

Hinweis

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

Das Tool „xsltc.exe“ überprüft weder den Namen der Klasse (/class:name) noch den der Assembly (/out:assemblyName). Wenn die Namen nicht gültig sind, gibt die CLR entsprechende Fehlermeldungen aus.

Beispiele

Der folgende Befehl kompiliert das Stylesheet und erstellt eine Assembly mit dem Namen booksort.dll.

xsltc booksort.xsl

Der folgende Befehl kompiliert das Stylesheet und erstellt eine Assembly mit dem Namen booksort.dll und eine PDB-Datei mit dem Namen booksort.pdb.

xsltc booksort.xsl /debug

Der folgende Befehl kompiliert ein Stylesheet, das ein msxsl:script-Element enthält, und erstellt zwei Assemblys namens calc.dll und calc_Script1.dll.

xsltc /settings:script+ calc.xsl

Der folgende Befehl aktiviert die DTD-Verarbeitung und die Unterstützung für Skripts und erstellt zwei Assemblys namens myTest.dll und myTest_Script1.dll.

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

Der folgende Befehl kompiliert zwei Stylesheetmodule und eine Assembly mit dem Namen booksort.dll.

xsltc booksort.xsl output.xsl

Siehe auch