Vbc 工作

包裝 vbc.exe，產生可執行檔 (.exe)、動態連結程式庫 (.dll) 或程式碼模組 (. netmodule)。 如需 vbc.exe 的詳細資訊，請參閱 Visual Basic 命令列編譯器。

參數

下表說明 Vbc 工作的參數。

參數	描述
AdditionalLibPaths	選擇性 String[] 參數。 指定其他資料夾，以便在其中尋找 References 屬性 (Attribute) 中指定的組件。
AddModules	選擇性 String[] 參數。 讓編譯器允許您目前正在編譯的專案使用指定檔案中的所有型別資訊。 這個參數 (Parameter) 對應於 vbc.exe 編譯器的 /addmodule 參數 (Switch)。
BaseAddress	選擇性 String 參數。 指定 DLL 的基底位址 (Base Address)。 這個參數 (Parameter) 對應於 vbc.exe 編譯器的 /baseaddress 參數 (Switch)。
CodePage	選擇性 Int32 參數。 指定編譯過程中所有原始程式碼檔使用的字碼頁。 這個參數對應於 vbc.exe 編譯器的 /codepage 參數。
DebugType	選擇性 String[] 參數。 使編譯器產生偵錯資訊。 這個參數可能具有下列其中一個值： full pdbonly 預設值為 full，對執行的程式附加偵錯工具。 pdbonly 值讓程式在偵錯工具中啟動時進行原始程式碼偵錯，但是如果執行的程式是附加至偵錯工具，就只會顯示組合語言碼。 如需詳細資訊，請參閱 /debug (Visual Basic)。
DefineConstants	選擇性 String[] 參數。 定義條件式編譯器常數。 Symbol/value 配對通常由分號來分隔，並以下列語法指定： symbol1=value1;symbol2=value2 這個參數對應於 vbc.exe 編譯器的 /define 參數。
DelaySign	選擇性 Boolean 參數。 如果為 true，工作便會將公開金鑰 (Public Key) 置於組件中。 如果為 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。
LangVersion	選擇性 [String] 參數。 指定語言版本 ("9" 或 "10")。
LinkResources	選擇性 ITaskItem[] 參數。 在輸出檔中建立 .NET Framework 資源的連結；資源檔並非置於輸出檔中。 這個參數對應於 vbc.exe 編譯器的 /linkresource 參數。
MainEntryPoint	選擇性 String 參數。 指定包含 Sub Main 程序的類別或模組。 這個參數對應於 vbc.exe 編譯器的 /main 參數。
ModuleAssemblyName	選擇性 String 參數。 指定此模組所屬的組件。
NoConfig	選擇性 Boolean 參數。 指定編譯器不應該使用 vbc.rsp 檔。 這個參數對應於 vbc.exe 編譯器的 /noconfig 參數。
NoLogo	選擇性 Boolean 參數。 如果為 true，則隱藏編譯器橫幅資訊的顯示。 這個參數對應於 vbc.exe 編譯器的 /nologo 參數。
NoStandardLib	選擇性 Boolean 參數。 導致編譯器不參考標準程式庫。 這個參數對應於 vbc.exe 編譯器的 /nostdlib 參數。
NoVBRuntimeReference	選擇性 Boolean 參數。 僅限內部使用。 如果為 true，則阻止 Microsoft.VisualBasic.dll 的自動參考。
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 參數。
OptionInfer	選擇性 Boolean 參數。 如果為 true，則允許變數的型別推斷。
OptionStrict	選擇性 Boolean 參數。 如果為 true，工作便會強制嚴格型別語意以限制隱含型別轉換。 這個參數對應於 vbc.exe 編譯器的 /optionstrict 參數。
OptionStrictType	選擇性 String 參數。 指定哪些嚴格型別語義產生警告。 目前僅支援 "custom"。 這個參數對應於 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 編譯器的 /removeintcheck 參數。
Resources	選擇性 ITaskItem[] 參數。 將 .NET Framework 資源嵌入輸出檔。 這個參數對應於 vbc.exe 編譯器的 /resource 參數。
ResponseFiles	選擇性 ITaskItem[] 參數。 指定含有這個工作命令的回應檔 (Response File)。 這個參數對應於 vbc.exe 編譯器的 @ (Specify Response File) 選項。
RootNamespace	選擇性 String 參數。 指定所有型別宣告的根命名空間。 這個參數對應於 vbc.exe 編譯器的 /rootnamespace 參數。
SdkPath	選擇性 String 參數。 指定 mscorlib.dll 和 microsoft.visualbasic.dll 的位置。 此參數 (Parameter) 對應 vbc.exe 編譯器的 /sdkpath 參數 (switch)。
Sources	選擇性 ITaskItem[] 參數。 指定一個或多個 Visual Basic 原始程式檔 (Source File)。
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 之架構版本的 SDK 安裝路徑。
TreatWarningsAsErrors	選擇性 Boolean 參數。 如果為 true，則會將所有警告都視為錯誤。 如需詳細資訊，請參閱 /warnaserror (Visual Basic)。
UseHostCompilerIfAvailable	選擇性 Boolean 參數。 指示工作使用同處理序 (In-Process) 編譯器物件 (如果有)。 僅供 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檔，讓輸出檔具有在檔案總管中所需的外觀。 這個參數對應於 vbc.exe 編譯器的 /win32icon 參數。
Win32Resources	選擇性 String 參數。 將 Win32 資源 (.res) 檔插入輸出檔中。 這個參數對應於 vbc.exe 編譯器的 /win32resource 參數。

備註

除了以上列出的參數之外，此項工作還會繼承 ToolTaskExtension 類別中的參數，而該類別本身又繼承 ToolTask 類別。 如需這些錯誤碼的清單及其說明，請參閱 ToolTaskExtension 基底類別。

範例

下列程式碼範例會編譯 Visual Basic 專案。

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

請參閱

概念

MSBuild 工作

其他資源

Visual Basic 命令列編譯器

MSBuild 工作參考