Задача Vbc
Создает программу-оболочку для компилятора vbc.exe, создающего исполняемые файлы (EXE-файлы), библиотеки динамической компоновки (DLL-файлы) и модули кода ( NETMODULE). Дополнительные сведения о программе vbc.exe см. в разделе Компилятор Visual Basic с интерфейсом командной строки.
Параметры
В следующей таблице описаны параметры задачи Vbc.
Параметр |
Описание |
|---|---|
AdditionalLibPaths |
Необязательный параметр типа String[]. Задает дополнительные папки, в которых производится поиск сборок, указанных в атрибуте References. |
AddModules |
Необязательный параметр типа String[]. Делает доступными все сведения из указанных файлов для компилируемого проекта. Этот параметр соответствует ключу /addmodule компилятора vbc.exe. |
BaseAddress |
Необязательный параметр типа String. Задает базовый адрес библиотеки DLL. Этот параметр соответствует ключу /baseaddress компилятора vbc.exe. |
CodePage |
Необязательный параметр типа Int32. Задает кодовую страницу, используемую для всех файлов исходного кода при компиляции. Этот параметр соответствует ключу /codepage компилятора vbc.exe. |
DebugType |
Необязательный параметр типа String[]. Указывает компилятору создавать отладочную информацию. Этот параметр может принимать следующие значения:
По умолчанию используется значение full, которое позволяет присоединить отладчик к выполняющейся программе. Значение pdbonly позволяет выполнить отладку исходного кода при запуске программы в отладчике, но ассемблерный код отображается только тогда, когда запущенная программа присоединяется к отладчику. Дополнительные сведения см. в разделе /debug (Visual Basic). |
DefineConstants |
Необязательный параметр типа String[]. Определение констант условной компиляции. Пары символ/значение разделяются точками с запятой и задаются с помощью следующего синтаксиса: символ_1=значение_1;символ_2=значение_2 Этот параметр соответствует ключу /define компилятора vbc.exe. |
DelaySign |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, задача добавляет в сборку открытый ключ. Если этот параметре имеет значение false, задача полностью подписывает сборку. По умолчанию используется значение false. Этот параметр не оказывает никакого влияния, если он не используется вместе с параметром KeyFile или с параметром KeyContainer. Этот параметр соответствует ключу /delaysign компилятора vbc.exe. |
DisabledWarnings |
Необязательный параметр типа String. Отключает указанные предупреждения. Необходимо указать только числовую часть идентификатора предупреждения. Несколько предупреждений отделяются друг от друга точкой с запятой. Этот параметр соответствует ключу /nowarn компилятора vbc.exe. |
DocumentationFile |
Необязательный параметр типа String. Помещает комментарии для документации в указанный XML-файл. Этот параметр переопределяет атрибут GenerateDocumentation. Дополнительные сведения см. в разделах /doc. |
EmitDebugInformation |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, задача создает отладочную информацию и помещает ее в PDB-файл. Дополнительные сведения см. в разделе /debug (Visual Basic). |
ErrorReport |
Необязательный параметр типа String. Указывает, как задача должна сообщать о внутренних ошибках компилятора. Этот параметр может принимать следующие значения:
Если используется значение prompt, при возникновении внутренних ошибок компилятора пользователь получает сообщение с предложением отправить данные об ошибке в корпорацию Майкрософт. Если используется значение send, при возникновении внутренних ошибок компилятора задача самостоятельно отправляет данные об ошибке в корпорацию Майкрософт. По умолчанию используется значение none, при котором выводится только текст сообщения об ошибке. Этот параметр соответствует ключу /errorreport компилятора vbc.exe. |
FileAlignment |
Необязательный параметр типа Int32. Определение (в байтах), где выровнять разделы выходного файла. Этот параметр может принимать следующие значения:
Этот параметр соответствует ключу /filealign компилятора vbc.exe. |
GenerateDocumentation |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, генерируются комментарии для документации и помещаются в XML-файл вместе с именем выполняемого файла или библиотеки, которые созданы задачей. Дополнительные сведения см. в разделах /doc. |
Imports |
Необязательный параметр ITaskItem[] . Осуществляет импорт пространства имен из указанных коллекций элементов. Этот параметр соответствует ключу /imports компилятора vbc.exe. |
KeyContainer |
Необязательный параметр типа String. Задает имя контейнера криптографического ключа. Этот параметр соответствует ключу /keycontainer компилятора vbc.exe. |
KeyFile |
Необязательный параметр типа String. Задает имя файла, содержащего криптографический ключ. Дополнительные сведения см. в разделе /keyfile. |
LangVersion |
Необязательный параметр типа [String]. Указывает версию языка, «9»или «10». |
LinkResources |
Необязательный параметр ITaskItem[] . Создает ссылку на ресурс .NET Framework в выходном файле; не включает файл ресурса в выходной файл. Этот параметр соответствует ключу /linkresource компилятора vbc.exe. |
MainEntryPoint |
Необязательный параметр типа String. Указывает класс или модуль, содержащий процедуру Sub Main. Этот параметр соответствует ключу /main компилятора vbc.exe. |
ModuleAssemblyName |
Необязательный параметр типа String. Указывает сборку, частью которой является этот модуль. |
NoConfig |
Необязательный параметр типа Boolean. Предписывает компилятору не использовать файл vbc.rsp. Этот параметр соответствует параметру /noconfig компилятора vbc.exe. |
NoLogo |
Необязательный параметр типа Boolean. Если этот параметр равен true, отображение заголовка компилятора отключается. Этот параметр соответствует ключу /nologo компилятора vbc.exe. |
NoStandardLib |
Необязательный параметр типа Boolean. Предписывает компилятору не ссылаться на стандартные библиотеки. Этот параметр соответствует ключу /nostdlib компилятора vbc.exe. |
NoVBRuntimeReference |
Необязательный параметр типа Boolean. Только для внутреннего использования. Если true, предотвращает автоматическое ссылки на библиотеку Microsoft.VisualBasic.dll. |
NoWarnings |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, все предупреждения будут отключены. Дополнительные сведения см. в разделе /nowarn. |
Optimize |
Необязательный параметр типа Boolean. Значение true включает оптимизацию компилятора. Этот параметр соответствует ключу /optimize компилятора vbc.exe. |
OptionCompare |
Необязательный параметр типа String. Задает способ сравнения строк. Этот параметр может принимать следующие значения:
Значение binary указывает задаче использовать двоичное сравнение строк. Значение text указывает задаче использовать текстовое сравнение строк. По умолчанию этот параметр имеет значение binary. Этот параметр соответствует ключу /optioncompare компилятора vbc.exe. |
OptionExplicit |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, необходимо явное объявление переменных. Этот параметр соответствует ключу /optionexplicit компилятора vbc.exe. |
OptionInfer |
Необязательный параметр типа Boolean. true разрешает вывод типа переменных. |
OptionStrict |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, задача применяет семантику строгого типа для ограничения неявных преобразований типов. Этот параметр соответствует ключу /optionstrict компилятора vbc.exe. |
OptionStrictType |
Необязательный параметр типа String. Определяет, какая семантика строгого типа создает предупреждение. В настоящее время только "custom" поддерживается. Этот параметр соответствует ключу /optionstrict компилятора vbc.exe. |
OutputAssembly |
Необязательный выходной параметр типа String. Задает имя выходного файла. Этот параметр соответствует ключу /out компилятора vbc.exe. |
Platform |
Необязательный параметр типа String. Задает платформу процессора, для которой следует создавать выходной файл. Этот параметр может иметь следующие значения: x86, x64, Itanium или anycpu. По умолчанию используется значение anycpu. Этот параметр соответствует ключу /platform компилятора vbc.exe. |
References |
Необязательный параметр ITaskItem[] . Вызывает импорт задачей информации об открытых типах из заданных элементов в текущий проект. Этот параметр соответствует ключу /reference компилятора vbc.exe. |
RemoveIntegerChecks |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, проверки целочисленного переполнения отключены. Значение по умолчанию — false. Этот параметр соответствует ключу /removeintchecks компилятора vbc.exe. |
Resources |
Необязательный параметр ITaskItem[] . Включает ресурс .NET Framework в выходной файл. Этот параметр соответствует ключу /resource компилятора vbc.exe. |
ResponseFiles |
Необязательный параметр ITaskItem[] . Задает файл ответов, содержащий команды для данной задачи. Этот параметр соответствует параметру @ (Specify Response File) компилятора vbc.exe. |
RootNamespace |
Необязательный параметр типа String. Указывает корневое пространство имен для всех объявлений типов. Этот параметр соответствует ключу /rootnamespace компилятора vbc.exe. |
SdkPath |
Необязательный параметр типа String. Указывает расположение библиотек mscorlib.dll и microsoft.visualbasic.dll. Этот параметр соответствует ключу /sdkpath компилятора vbc.exe. |
Sources |
Необязательный параметр ITaskItem[] . Задает один или несколько исходных файлов Visual Basic. |
TargetCompactFramework |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, .NET Compact Framework является для задачи целевой платформой. Этот параметр соответствует ключу /netcf компилятора vbc.exe. |
TargetType |
Необязательный параметр типа String. Задает формат выходного файла. Этот параметр может принимать одно из следующих значений: library (создается библиотека кода), exe (создается консольное приложение), module (создается модуль) или winexe (создается Windows-программа). По умолчанию используется значение library. Этот параметр соответствует ключу /target компилятора vbc.exe. |
Timeout |
Необязательный параметр типа Int32. Указывает временной интервал в миллисекундах, по истечении которого исполнение файла задачи останавливается. Значение по умолчанию Int.MaxValue указывает, что таймаут не задан. |
ToolPath |
Необязательный параметр типа String. Указывает расположение, откуда задача будет загружать базовый исполняемый файл (vbc.exe). Если этот параметр не задан, задача использует путь установки пакета SDK, соответствующий версии среды, в которой выполняется MSBuild. |
TreatWarningsAsErrors |
Необязательный параметр типа Boolean. Если этот параметр имеет значение true, все предупреждения обрабатываются как ошибки. Дополнительные сведения см. в разделе /warnaserror (Visual Basic). |
UseHostCompilerIfAvailable |
Необязательный параметр типа Boolean. Предписывает задаче использовать внутрипроцессный объект компилятора, если он доступен. Используется только Visual Studio. |
Utf8Output |
Необязательный параметр типа Boolean. Регистрирует выходные данные компилятора в кодировке UTF-8. Этот параметр соответствует ключу /utf8output компилятора vbc.exe. |
Verbosity |
Необязательный параметр типа String. Задает уровень детализации выходных данных компилятора. Детализация может иметь значение Quiet, Normal (по умолчанию) или Verbose. |
WarningsAsErrors |
Необязательный параметр типа String. Задает список предупреждений, которые следует обрабатывать как ошибки. Дополнительные сведения см. в разделе /warnaserror (Visual Basic). Этот параметр переопределяет параметр TreatWarningsAsErrors. |
WarningsNotAsErrors |
Необязательный параметр типа String. Задает список предупреждений, которые не следует обрабатывать как ошибки. Дополнительные сведения см. в разделе /warnaserror (Visual Basic). Этот параметр имеет смысл только в том случае, если параметр TreatWarningsAsErrors имеет значение true. |
Win32Icon |
Необязательный параметр типа String. Вставляет ico-файл в сборку, которая присваивает выходному файлу нужного обозревателе файла внешнего вида. Этот параметр соответствует ключу /win32icon компилятора vbc.exe. |
Win32Resources |
Необязательный параметр типа String. Внедряет файл ресурсов Win32 (RES-файл) в выходной файл. Этот параметр соответствует ключу /win32resource компилятора vbc.exe. |
Заметки
Помимо параметров, которые перечислены выше, эта задача наследует параметры от класса ToolTaskExtension, который наследует от класса ToolTask. Чтобы получить список этих доп параметров и их описаний, см. Базовый класс ToolTaskExtension.
Пример
В следующем примере демонстрируется компиляция проекта Visual Basic.
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>