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По умолчанию задано значение full, разрешающее подключение отладчика к исполняемой программе. Значение pdbonly позволяет выполнять отладку исходного кода при запуске программы в отладчике, но при этом код языка сборки отображается только при подключении выполняющейся программы к отладчику. Дополнительные сведения см. в разделе -debug (Visual Basic). |
DefineConstants |
Необязательный параметр String[].Задает константы условной компиляции. Пары "символ — значение" разделяются точками с запятой и задаются с использованием следующего синтаксиса. symbol1 = value1 ; symbol2 = value2Этот параметр соответствует параметру -define компилятора vbc.exe. |
DelaySign |
Необязательный параметр Boolean.Если присвоено значение true, задача помещает открытый ключ в сборку. Если присвоено значение false, задача полностью подписывает сборку. Значение по умолчанию — false. Этот параметр действует только при использовании параметра KeyFile или KeyContainer. Этот параметр соответствует параметру -delaysign компилятора vbc.exe. |
Deterministic |
Необязательный параметр Boolean.Если задано значение true, компилятор будет выдавать сборку, чье двоичное содержимое идентично в разных компиляциях, если входные данные идентичны.Дополнительные сведения см. в разделе -deterministic. |
DisabledWarnings |
Необязательный параметр String.Подавляет указанные предупреждения. Необходимо указать только числовую часть идентификатора предупреждения. При указании нескольких предупреждений они отделяются друг от друга точкой с запятой. Этот параметр соответствует параметру -nowarn компилятора vbc.exe. |
DocumentationFile |
Необязательный параметр String.Обрабатывает комментарии к документации в указанный XML-файл. Этот параметр переопределяет атрибут GenerateDocumentation. Дополнительные сведения см. в разделе -doc. |
EmitDebugInformation |
Необязательный параметр Boolean.Если присвоено значение true, задача генерирует отладочную информацию и помещает ее в PDB-файл. Дополнительные сведения см. в разделе -debug (Visual Basic). |
ErrorReport |
Необязательный параметр String.Указывает, как задача должна сообщать о внутренних ошибках компилятора. Этот параметр может иметь следующие значения: - prompt- send- noneЕсли задано значение prompt, то при возникновении внутренней ошибки компилятора пользователю предлагается возможность отправить сведения об ошибке в корпорацию Майкрософт.Если присвоено значение, send при возникновении внутренней ошибки компилятора задача отправляет данные об ошибке в корпорацию Майкрософт.Значение по умолчанию — none, при котором сообщение об ошибке отправляется только в виде текста.Этот параметр соответствует параметру -errorreport компилятора vbc.exe. |
FileAlignment |
Необязательный параметр Int32.Задает выравнивание размеров выходного файла в байтах. Этот параметр может иметь следующие значения: - 512- 1024- 2048- 4096- 8192Этот параметр соответствует параметру -filealign компилятора vbc.exe. |
GenerateDocumentation |
Необязательный параметр Boolean.Если присвоено значение true, в процессе сборки создается информация документации и помещается в XML-файл вместе с именем исполняемого файла или библиотеки, созданных задачей. Дополнительные сведения см. в разделе -doc. |
Imports |
Необязательный параметр ITaskItem[].Импорт пространства имен из указанных коллекций элементов. Этот параметр соответствует параметру -imports компилятора vbc.exe. |
KeyContainer |
Необязательный параметр String.Задает имя контейнера криптографического ключа. Этот параметр соответствует параметру -keycontainer компилятора vbc.exe. |
KeyFile |
Необязательный параметр String.Задает имя файла, содержащего криптографический ключ. Дополнительные сведения см. в разделе -keyfile. |
LangVersion |
Необязательный параметр System.String. Задает используемую версию языка (например, 15.5). |
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 указывает на то, что в задаче используются двоичные сравнения строк. Значение 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[].Задает файл ответов, содержащий команды для этой задачи. Этот параметр соответствует параметру @ (указание файла ответа) компилятора 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
Эта задача наследуется от класса ToolTaskExtension, который наследуется от класса ToolTask, который, в свою очередь, наследуется от класса Task. Эта цепочка наследования добавляет несколько параметров в задачи, которые от них происходят.
В следующей таблице описываются параметры базовых классов:
| Параметр | Описание |
|---|---|
| EchoOff | Необязательный параметр bool.Если задано значение true, то задача передает /Q в командную строку cmd.exe и командная строка не копируется в stdout. |
| EnvironmentVariables | Необязательный параметр массива String.Массив определений переменных среды, разделенных точкой с запятой. Каждое определение должно содержать имя и значение переменной среды, разделенные знаком равенства. Эти переменные частично передаются в порожденный исполняемый файл, дополняя или выборочно переопределяя обычный блок среды. Например, Variable1=Value1;Variable2=Value2. |
| ExitCode | Необязательный выходной параметр Int32, доступный только для чтения.Задает код выхода, предоставляемый выполняемой командой. Если задача зарегистрировала какие-либо ошибки, но процесс имеет код выхода 0 (успешное завершение), этот параметр имеет значение -1. |
| LogStandardErrorAsError | Необязательный параметр bool.Если он имеет значение true, то все сообщения, полученные в стандартном потоке ошибок, регистрируются как ошибки. |
| StandardErrorImportance | Необязательный параметр String.степень важности, с которой текст из стандартного потока ошибок следует регистрировать в журнале. |
| StandardOutputImportance | Необязательный параметр String.Степень важности, с которой текст из стандартного выходного потока следует регистрировать в журнале. |
| Timeout | Необязательный параметр Int32.Задает промежуток времени в миллисекундах, после которого исполняемый файл задачи прекращается. Значение по умолчанию — Int.MaxValue. Оно указывает, что период ожидания отсутствует. Время ожидания в миллисекундах. |
| ToolExe | Необязательный параметр string.Он может реализовываться в проектах для переопределения параметра ToolName. Задачи могут переопределять его для сохранения параметра ToolName. |
| ToolPath | Необязательный параметр string.Указывает расположение, откуда задача загружает базовый исполняемый файл. Если этот параметр не задан, задача использует путь установки пакета SDK, соответствующий версии платформы, на которой выполняется MSBuild. |
| UseCommandProcessor | Необязательный параметр bool.Если задано значение true, эта задача создает пакетный файл для командной строки и выполняет его с помощью командного процессора вместо непосредственного выполнения команды. |
| YieldDuringToolExecution | Необязательный параметр bool.Если задано значение true, эта задача создает узел при выполнении его задачи. |
Пример
В следующем примере компилируется проект Visual Basic.
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>