XSLT-компилятор (xsltc.exe)

Компилятор XSLT (xsltc.exe) компилирует таблицы стилей XSLT и создает сборку. Затем скомпилированный лист стилей можно передать непосредственно в XslCompiledTransform.Load(Type) метод. Вы не можете создавать подписанные сборки с помощью xsltc.exe.

Замечание

Блоки скриптов поддерживаются только в .NET Framework. Они не поддерживаются в .NET Core или .NET 5 или более поздней версии.

Средство xsltc.exe входит в состав Visual Studio. Дополнительные сведения см. в разделе "Загрузки Visual Studio".

Синтаксис

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

Аргумент

Аргумент Описание
sourceFile Задает имя таблицы стилей. Таблица стилей должна быть локальным файлом или находиться в интрасети.

Опции

Вариант Описание
/c[lass]: name Указывает имя класса для следующей таблицы стилей. Имя класса может быть полностью определённым.

Имя класса по умолчанию — имя таблицы стилей. Например, если таблица стилей customers.xsl компилируется, имя класса по умолчанию — клиенты.
/debug[+|-] Указывает, следует ли создавать сведения об отладке.

Указание + или /debug, в результате чего компилятор создает сведения об отладке и помещает их в файл базы данных программы (PDB). Имя созданного PDB-файла — assemblyNamePDB.

Указание -, которое действует, если вы не указываете /debug, не приводит к созданию отладочной информации. Создается розничная сборка. Заметка: Компиляция в режиме отладки может значительно повлиять на производительность XSLT.
/help Отображает синтаксис команд и параметров программы.
/nologo Запрещает отображение сообщения об авторских правах компилятора.
/platform: string Указывает платформы, на которые можно запустить сборку. Ниже описаны допустимые значения платформы:

x86 компилирует сборку, выполняемую 32-разрядной средой CLR, совместимой с x86

x64 компилирует вашу сборку для запуска 64-битной общей языковой среды выполнения на компьютере, поддерживающем набор инструкций AMD64 или EM64T.

Itanium компилирует вашу сборку для выполнения 64-разрядной общей средой выполнения на компьютере с процессором Itanium.

anycpu компилирует сборку для выполнения на любой платформе. Это значение по умолчанию.
/out: assemblyName Указывает имя выходной сборки. Имя сборки по умолчанию имеет имя основной таблицы стилей или первой таблицы стилей, если присутствуют несколько таблиц стилей.

Если таблица стилей содержит скрипты, скрипты сохраняются в отдельной сборке. Имена сборок скрипта создаются из имени основной сборки. Например, если вы указали CustOrders.dll для имени сборки, первая сборка скрипта называется CustOrders_Script1.dll.
/settings: document+-, script+-, DTD+-, Указывает, следует ли разрешать document() функции, скрипт XSLT или определение типа документа (DTD) в стилевом листе.

Поведение по умолчанию отключает поддержку DTD, document() функции и скриптов.
@ file Позволяет указать файл, содержащий параметры компилятора.
? Отображает синтаксис команд и параметров программы.

Замечания

Решения XSLT могут состоять из нескольких модулей таблицы стилей. Средство xsltc.exe создает сборки из таблиц стилей. Затем сборки можно передать в XslCompiledTransform.Load(Type) метод. Это может помочь снизить затраты на производительность в некоторых сценариях развертывания XSLT.

Замечание

В приложение также необходимо включить скомпилированную сборку в качестве ссылки.

Средство xsltc.exe не проверяет имена классов (/class:имя) или сборки (/out:assemblyName). Ошибки генерируются общеязыковым временем выполнения, если имена недействительны.

Примеры

Следующая команда компилирует таблицу стилей и создает сборку с именем booksort.dll.

xsltc booksort.xsl

Следующая команда компилирует таблицу стилей и создает файл сборки и PDB, которые называются booksort.dll и bookort.pdb соответственно.

xsltc booksort.xsl /debug

Следующая команда компилирует таблицу стилей, содержащую msxsl:script элемент, и создает две сборки с именем calc.dll и calc_Script1.dll.

xsltc /settings:script+ calc.xsl

Следующая команда включает поддержку обработки DTD и скрипта и создает две сборки с именем myTest.dll и myTest_Script1.dll.

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

Следующая команда компилирует два модуля таблицы стилей и создает одну сборку с именем booksort.dll.

xsltc booksort.xsl output.xsl

См. также