Share via

Vbc 任务

  • 项目

更新：2007 年 11 月

包装产生可执行文件 (.exe)、动态链接库 (.dll) 或代码模块 (.netmodule) 的 vbc.exe。有关 vbc.exe 的更多信息，请参见 Visual Basic 编译器。

参数

下表描述了 Vbc 任务的参数。

参数

说明

AdditionalLibPaths

可选的 String[] 参数。

指定其他文件夹，将在这些文件夹中查找 References 属性中指定的程序集。

AddModules

可选的 String[] 参数。

使编译器将指定文件中的所有类型信息对当前正在编译的项目可用。此参数对应于 vbc.exe 编译器的 /addmodule 开关。

BaseAddress

可选的 String 参数。

指定 DLL 的基址。此参数对应于 vbc.exe 编译器的 /baseaddress 开关。

CodePage

可选的 Int32 参数。

指定要用于编译中所有源代码文件的代码页。此参数对应于 vbc.exe 编译器的 /codepage 开关。

DebugType

可选的 String[] 参数。

使编译器生成调试信息。此参数可以具有下列值：

  • full

  • pdbonly

默认值为 full，允许将调试器附加到正在运行的程序。pdbonly 值允许在调试器中启动程序的时候进行源代码调试，但是，只有当将正在运行的程序附加到调试器时，才显示汇编语言代码。有关更多信息，请参见 /debug (Visual Basic)。

DefineConstants

可选的 String[] 参数。

定义条件编译器常数。符号/值对是使用下面的语法指定的，并且彼此之间用分号分隔：

符号 1=值 1;符号 2=值 2

此参数对应于 vbc.exe 编译器的 /define 开关。

DelaySign

可选的 Boolean 参数。

如果设置为 true，任务会将公钥放置在程序集中。如果设置为 false，则任务会对程序集进行完整签名。默认值为 false。除非与 KeyFile 参数或 KeyContainer 参数结合使用，否则此参数不会产生任何效果。此参数对应于 vbc.exe 编译器的 /delaysign 开关。

DisabledWarnings

可选的 String 参数。

禁止显示指定的警告。仅需要指定警告标识符的数值部分。多个警告之间用分号分隔。此参数对应于 vbc.exe 编译器的 /nowarn 开关。

DocumentationFile

可选的 String 参数。

将文档注释处理到一个指定的 XML 文件中。此参数重写 GenerateDocumentation 属性。有关更多信息，请参见 /doc。

EmitDebugInformation

可选的 Boolean 参数。

如果设置为 true，任务将生成调试信息，并将该信息放置在 .pdb 文件中。有关更多信息，请参见 /debug (Visual Basic)。

ErrorReport

可选的 String 参数。

指定任务报告内部编译器错误的方式。此参数可以具有下列值：

  • prompt

  • send

  • none

如果指定了 prompt，那么当发生内部编译器错误时，系统将通过一个选项来询问用户是否将错误数据发送到 Microsoft。

如果指定了 send，那么当发生内部编译器错误时，任务会将错误数据发送到 Microsoft。

默认值为 none，这意味着仅在文本输出中报告错误。

此参数对应于 vbc.exe 编译器的 /errorreport 开关。

FileAlignment

可选的 Int32 参数。

指定输出文件各部分的对齐位置，以字节为单位。此参数可以具有下列值：

  • 512

  • 1024

  • 2048

  • 4096

  • 8192

此参数对应于 vbc.exe 编译器的 /filealign 开关。

GenerateDocumentation

可选的 Boolean 参数。

如果设置为 true，将生成文档信息，并将此信息放置在与任务正在创建的可执行文件或库的名称相同的 XML 文件中。有关更多信息，请参见 /doc。

Imports

可选的 ITaskItem[] 参数。

从指定的项集合导入命名空间。此参数对应于 vbc.exe 编译器的 /imports 开关。

KeyContainer

可选的 String 参数。

指定加密密钥容器的名称。此参数对应于 vbc.exe 编译器的 /keycontainer 开关。

KeyFile

可选的 String 参数。

指定包含加密密钥的文件名。有关更多信息，请参见 /keyfile。

LinkResources

可选的 ITaskItem[] 参数。

在输出文件中创建指向 .NET Framework 资源的链接；资源文件没有放置在输出文件中。此参数对应于 vbc.exe 编译器的 /linkresource 开关。

传入到此参数中的项可以具有名为 LogicalName 和 Access 的可选元数据项。LogicalName 对应于 /linkresource 开关的 identifier 参数，Access 对应于 filename 参数。

MainEntryPoint

可选的 String 参数。

指定包含 Sub Main 过程的类或模块。此参数对应于 vbc.exe 编译器的 /main 开关。

NoConfig

可选的 Boolean 参数。

指定编译器不应使用 vbc.rsp 文件。此参数对应于 vbc.exe 编译器的 /noconfig 参数。

NoLogo

可选的 Boolean 参数。

如果为 true，将禁止显示编译器版本标志信息。此参数对应于 vbc.exe 编译器的 /nologo 开关。

NoStandardLib

可选的 Boolean 参数。

使编译器不引用标准库。此参数对应于 vbc.exe 编译器的 /nostdlib 开关。

NoWarnings

可选的 Boolean 参数。

如果设置为 true，任务将禁止显示所有警告。有关更多信息，请参见 /nowarn。

Optimize

可选的 Boolean 参数。

如果设置为 true，将启用编译器优化。此参数对应于 vbc.exe 编译器的 /optimize 开关。

OptionCompare

可选的 String 参数。

指定如何进行字符串比较。此参数可以具有下列值：

  • binary

  • text

如果值为 binary，表示任务应使用二进制字符串比较。如果值为 text，表示任务应使用文本字符串比较。此参数的默认值为 binary。此参数对应于 vbc.exe 编译器的 /optioncompare 开关。

OptionExplicit

可选的 Boolean 参数。

如果设置为 true，将需要显式声明变量。此参数对应于 vbc.exe 编译器的 /optionexplicit 开关。

OptionStrict

可选的 Boolean 参数。

如果设置为 true，任务将强制使用严格类型语义以限制隐式类型转换。此参数对应于 vbc.exe 编译器的 /optionstrict 开关。

OutputAssembly

可选的 String 输出参数。

指定输出文件的名称。此参数对应于 vbc.exe 编译器的 /out 开关。

Platform

可选的 String 参数。

指定输出文件的目标处理器平台。此参数的值可以为 x86、x64、Itanium 或 anycpu。默认值为 anycpu。此参数对应于 vbc.exe 编译器的 /platform 开关。

References

可选的 ITaskItem[] 参数。

使任务将公共类型信息从指定项导入到当前项目。此参数对应于 vbc.exe 编译器的 /reference 开关。

RemoveIntegerChecks

可选的 Boolean 参数。

如果设置为 true，将禁止执行整数溢出错误检查。默认值为 false。此参数对应于 vbc.exe 编译器的 /removeintchecks 开关。

Resources

可选的 ITaskItem[] 参数。

将一个 .NET Framework 资源嵌入到输出文件中。此参数对应于 vbc.exe 编译器的 /resource 开关。

传入到此参数中的项可以具有名为 LogicalName 和 Access 的可选元数据项。LogicalName 对应于 /resource 开关的 identifier 参数，Access 对应于 filename 参数。

ResponseFiles

可选的 ITaskItem[] 参数。

指定包含此任务的命令的响应文件。此参数对应于 vbc.exe 编译器的 @（指定响应文件）选项。

RootNamespace

可选的 String 参数。

为所有类型声明指定根命名空间。此参数对应于 vbc.exe 编译器的 /rootnamespace 开关。

SdkPath

可选的 String 参数。

指定 mscorlib.dll 和 microsoft.visualbasic.dll 的位置。此参数对应于 vbc.exe 编译器的 /sdkpath 开关。

Sources

可选的 ITaskItem[] 参数。

指定一个或多个 Visual Basic 源文件。

TargetCompactFramework

可选的 Boolean 参数。

如果设置为 true，则任务面向 .NET Compact Framework。此开关对应于 vbc.exe 编译器的 /netcf 开关。

TargetType

可选的 String 参数。

指定输出文件的文件格式。此参数的值可以为 library（创建代码库）、exe（创建控制台应用程序）、module（创建模块）或 winexe（创建 Windows 程序）。默认值为 library。此参数对应于 vbc.exe 编译器的 /target 开关。

Timeout

可选的 Int32 参数。

指定在多少毫秒后终止任务可执行文件。默认值为 Int.MaxValue，这表示没有超时期限。

ToolPath

可选的 String 参数。

指定任务将从什么位置加载基础可执行文件 (vbc.exe)。如果未指定此参数，任务将使用与运行 MSBuild 的 Framework 版本对应的 SDK 安装路径。

TreatWarningsAsErrors

可选的 Boolean 参数。

如果设置为 true，则所有警告都将被视为错误。有关更多信息，请参见 /warnaserror (Visual Basic)。

UseHostCompilerIfAvailable

可选的 Boolean 参数。

指示任务使用进程内编译器对象（如果有的话）。仅由 Visual Studio 使用。

Utf8Output

可选的 Boolean 参数。

使用 UTF-8 编码记录编译器输出。此参数对应于 vbc.exe 编译器的 /utf8output 开关。

Verbosity

可选的 String 参数。

指定编译器输出的详细级别。详细级别可以为 Quiet、Normal（默认值）或 Verbose。

WarningsAsErrors

可选的 String 参数。

指定将被视为错误的警告的列表。有关更多信息，请参见 /warnaserror (Visual Basic)。

此参数重写 TreatWarningsAsErrors 参数。

WarningsNotAsErrors

可选的 String 参数。

指定不被视为错误的警告的列表。有关更多信息，请参见 /warnaserror (Visual Basic)。

只有当 TreatWarningsAsErrors 参数设置为 true 时，此参数才有用。

Win32Icon

可选的 String 参数。

在程序集中插入 .ico 文件，使输出文件在 Windows 资源管理器中具有所需的外观。此参数对应于 vbc.exe 编译器的 /win32icon 开关。

Win32Resources

可选的 String 参数。

在输出文件中插入 Win32 资源文件 (.res)。此参数对应于 vbc.exe 编译器的 /win32resource 开关。

示例

下面的示例编译一个 Visual Basic 项目。

<VBC
   Sources="@(sources)"
   Resources="strings.resources"
   Optimize="true"
   OutputAssembly="out.exe"/>

请参见

概念

MSBuild 任务

其他资源

Visual Basic 编译器

MSBuild 任务参考