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>...]

Аргумент

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

Параметры

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

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

Задание значения + или /debug включает создание компилятором отладочных сведений, которые размещаются в файле базы данных программы (PDB). Создаваемый PDB-файл получает имя assemblyName.pdb.

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

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

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

Itanium компилирует сборку для выполнения в 64-разрядной среде CLR на компьютере с процессором 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:name) и сборки (/out:assemblyName). Ошибки возникают средой CLR, если имена недопустимы.

Примеры

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

xsltc booksort.xsl

Следующая команда компилирует таблицу стилей и создает сборку и PDB-файл, которые называются booksort.dll и booksort.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

См. также