Share via

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"/>

См. также