XSLT-Compiler (xsltc.exe)
Aktualisiert: November 2007
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.
Das Tool xsltc.exe ist Bestandteil von Visual Studio 2008. Weitere Informationen finden Sie im Microsoft Download Center.
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, was im Endeffekt dasselbe ist, wie /debug nicht anzugeben, werden keine Debuginformationen erstellt. Es wird eine Retailassembly generiert.
|
||
/help |
Zeigt die 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 der Standardwert. |
||
/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 die Befehlssyntax und Optionen für das Tool an. |
Hinweise
XSLT-Lösungen können aus mehreren Stylesheetmodulen bestehen. Das Tool xsltc.exe 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.
.gif "Hinweis") 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
Aufgaben
Gewusst wie: Ausführen einer XSLT-Transformation mittels einer Assembly