Kompilator XSLT (xsltc.exe)
Kompilator XSLT (xsltc.exe) kompiluje arkusze stylów XSLT i generuje zestaw. Skompilowany arkusz stylów można następnie przekazać bezpośrednio do XslCompiledTransform.Load(Type) metody . Nie można wygenerować podpisanych zestawów przy użyciu xsltc.exe.
Uwaga
Bloki skryptów są obsługiwane tylko w programie .NET Framework. Nie są one obsługiwane na platformie .NET Core lub .NET 5 lub nowszym.
Narzędzie xsltc.exe jest dołączone do programu Visual Studio. Aby uzyskać więcej informacji, zobacz Pliki do pobrania programu Visual Studio.
Składnia
xsltc [options] [/class:<name>] <sourceFile> [[/class:<name>] <sourceFile>...]
Argument
| Argument | opis |
|---|---|
sourceFile |
Określa nazwę arkusza stylów. Arkusz stylów musi być plikiem lokalnym lub znajdować się w intranecie. |
Opcje
| Opcja | Opis |
|---|---|
/c[lass]: name |
Określa nazwę klasy dla następującego arkusza stylów. Nazwa klasy może być w pełni kwalifikowana. Nazwa klasy jest domyślnie nazwą arkusza stylów. Jeśli na przykład arkusz stylów customers.xsl jest kompilowany, domyślna nazwa klasy to klienci. |
/debug[+|-] |
Określa, czy mają być generowane informacje debugowania. Określenie + elementu lub /debugpowoduje, że kompilator generuje informacje debugowania i umieszcza je w pliku bazy danych programu (PDB). Nazwa wygenerowanego pliku PDB to assemblyName.pdb.Określenie -wartości , która jest obowiązująca, jeśli nie zostanie określona /debug, powoduje, że żadne informacje debugowania nie zostaną utworzone. Generowany jest zestaw detaliczny. Uwaga: kompilowanie w trybie debugowania może znacząco wpłynąć na wydajność XSLT. |
/help |
Wyświetla składnię polecenia i opcje narzędzia. |
/nologo |
Pomija wyświetlanie komunikatu o prawach autorskich kompilatora. |
/platform: string |
Określa platformy, na których można uruchomić zestaw. Poniżej opisano prawidłowe wartości platformy:x86 kompiluje zestaw do uruchomienia przez 32-bitowe środowisko uruchomieniowe języka wspólnego zgodnego z x86x64 Kompiluje zestaw do uruchomienia przez 64-bitowe środowisko uruchomieniowe języka wspólnego na komputerze obsługującym zestaw instrukcji AMD64 lub EM64T.Itanium kompiluje zestaw do uruchomienia przez 64-bitowe środowisko uruchomieniowe języka wspólnego na komputerze z procesorem Itanium. anycpu kompiluje zestaw do uruchamiania na dowolnej platformie. Jest to opcja domyślna. |
/out: assemblyName |
Określa nazwę zestawu, który jest wynikiem. Nazwa zestawu jest domyślnie określana jako nazwa głównego arkusza stylów lub pierwszego arkusza stylów, jeśli istnieje wiele arkuszy stylów. Jeśli arkusz stylów zawiera skrypty, skrypty są zapisywane w osobnym zestawie. Nazwy zestawów skryptu są generowane na podstawie głównej nazwy zestawu. Jeśli na przykład określono CustOrders.dll nazwy zestawu, pierwszy zestaw skryptu nosi nazwę CustOrders_Script1.dll. |
/settings: document+-, script+-, DTD+-, |
Określa, czy zezwalać na document() funkcje, skrypt XSLT lub definicję typu dokumentu (DTD) w arkuszu stylów.Domyślne zachowanie wyłącza obsługę dtD, document() funkcji i skryptów. |
@ file |
Umożliwia określenie pliku zawierającego opcje kompilatora. |
? |
Wyświetla składnię polecenia i opcje narzędzia. |
Uwagi
Rozwiązania XSLT mogą składać się z wielu modułów arkusza stylów. Narzędzie xsltc.exe generuje zestawy na podstawie arkuszy stylów. Następnie zestawy można przekazać do XslCompiledTransform.Load(Type) metody . Może to pomóc zmniejszyć koszty wydajności w niektórych scenariuszach wdrażania XSLT.
Uwaga
Należy również dołączyć skompilowany zestaw jako odwołanie do aplikacji.
Narzędzie xsltc.exe nie weryfikuje nazw klas (/class:nazwa) ani zestawu (/out:assemblyName). Błędy są zgłaszane przez środowisko uruchomieniowe języka wspólnego, jeśli nazwy są nieprawidłowe.
Przykłady
Następujące polecenie kompiluje arkusz stylów i tworzy zestaw o nazwie booksort.dll.
xsltc booksort.xsl
Następujące polecenie kompiluje arkusz stylów i tworzy odpowiednio plik assembly i PDB o nazwie booksort.dll i booksort.pdb.
xsltc booksort.xsl /debug
Następujące polecenie kompiluje arkusz stylów zawierający msxsl:script element i tworzy dwa zestawy o nazwie calc.dll i calc_Script1.dll.
xsltc /settings:script+ calc.xsl
Następujące polecenie umożliwia obsługę przetwarzania i skryptów DTD oraz tworzy dwa zestawy o nazwie myTest.dll i myTest_Script1.dll.
xsltc /settings:DTD+,script+ /out:myTest calc.xsl
Następujące polecenie kompiluje dwa moduły arkusza stylów i tworzy jeden zestaw o nazwie booksort.dll.
xsltc booksort.xsl output.xsl
