Share via

Kompilator XSLT (xsltc.exe)

  • Artykuł

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 x86

x64 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

Zobacz też