Vbc タスクVbc Task

実行可能ファイル (.exe)、ダイナミック リンク ライブラリ (.dll)、またはコード モジュール (.netmodule) を生成する vbc.exe をラップします。Wraps vbc.exe, which produces executables (.exe), dynamic-link libraries (.dll), or code modules (.netmodule). vbc.exe の詳細については、「Visual Basic のコマンド ライン コンパイラ」を参照してください。For more information on vbc.exe, see Visual Basic Command-Line Compiler.

パラメーターParameters

Vbc タスクのパラメーターの説明を次の表に示します。The following table describes the parameters of the Vbc task.

パラメーターParameter 説明Description
AdditionalLibPaths 省略可能な String[] 型のパラメーターです。Optional String[] parameter.

参照属性に指定されているアセンブリを探す追加のフォルダーを指定します。Specifies additional folders in which to look for assemblies specified in the References attribute.
AddModules 省略可能な String[] 型のパラメーターです。Optional String[] parameter.

指定ファイル内のすべての型情報を現在のコンパイル対象のプロジェクトで使用できるようにします。Causes the compiler to make all type information from the specified file(s) available to the project you are currently compiling. このパラメーターは、vbc.exe コンパイラの /addmodule スイッチに相当します。This parameter corresponds to the /addmodule switch of the vbc.exe compiler.
BaseAddress 省略可能な String 型のパラメーターです。Optional String parameter.

DLL のベース アドレスを指定します。Specifies the base address of the DLL. このパラメーターは、vbc.exe コンパイラの /baseaddress スイッチに相当します。This parameter corresponds to the /baseaddress switch of the vbc.exe compiler.
CodePage 省略可能な Int32 型のパラメーターです。Optional Int32 parameter.

コンパイルですべてのソース コード ファイルに使用するコード ページを指定します。Specifies the code page to use for all source code files in the compilation. このパラメーターは、vbc.exe コンパイラの /codepage スイッチに相当します。This parameter corresponds to the /codepage switch of the vbc.exe compiler.
DebugType 省略可能な String[] 型のパラメーターです。Optional String[] parameter.

コンパイラにデバッグ情報を生成させます。Causes the compiler to generate debugging information. このパラメーターには、次の値を指定できます。This parameter can have the following values:

- full
- pdbonly

既定値は full です。実行中のプログラムにデバッガーをアタッチできます。The default value is full, which enables attaching a debugger to the running program. pdbonly を指定すると、プログラムがデバッガーで開始されたとき、ソース コードのデバッグが可能になりますが、実行中のプログラムがデバッガーにアタッチされているときにのみアセンブリ言語コードが表示されます。A value of pdbonly allows source code debugging when the program is started in the debugger, but displays assembly language code only when the running program is attached to the debugger. 詳細については、「/debug (Visual Basic)」を参照してください。For more information, see /debug (Visual Basic).
DefineConstants 省略可能な String[] 型のパラメーターです。Optional String[] parameter.

条件付きコンパイル定数を定義します。Defines conditional compiler constants. 次の構文に従い、シンボルと値のペアをセミコロン (;) で区切って指定します。Symbol/value pairs are separated by semicolons and are specified with the following syntax:

symbol1 = value1 ; symbol2 = value2symbol1 = value1 ; symbol2 = value2

このパラメーターは、vbc.exe コンパイラの /define スイッチに相当します。This parameter corresponds to the /define switch of the vbc.exe compiler.
DelaySign 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、公開鍵がアセンブリに配置されます。If true, the task places the public key in the assembly. false の場合、アセンブリに完全署名されます。If false, the task fully signs the assembly. 既定値は false です。KeyFile パラメーターまたは KeyContainer パラメーターと併用しない限り、このパラメーターは無効です。The default value is false.This parameter has no effect unless used with the KeyFile parameter or the KeyContainer parameter. このパラメーターは、vbc.exe コンパイラの /delaysign スイッチに相当します。This parameter corresponds to the /delaysign switch of the vbc.exe compiler.
DisabledWarnings 省略可能な String 型のパラメーターです。Optional String parameter.

指定された警告の出力を抑制します。Suppresses the specified warnings. 警告 ID の数値だけを指定します。You only need to specify the numeric part of the warning identifier. 複数の警告を指定するときは、セミコロン (;) で区切ります。Multiple warnings are separated by semicolons. このパラメーターは、vbc.exe コンパイラの /nowarn スイッチに相当します。This parameter corresponds to the /nowarn switch of the vbc.exe compiler.
DocumentationFile 省略可能な String 型のパラメーターです。Optional String parameter.

指定した XML ファイルにドキュメント コメントを出力します。Processes documentation comments to the specified XML file. このパラメーターは GenerateDocumentation 属性に優先します。This parameter overrides the GenerateDocumentation attribute. 詳細については、「/doc」を参照してください。For more information, see /doc.
EmitDebugInformation 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、デバッグ情報が生成され、.pdb ファイルに格納されます。If true, the task generates debugging information and places it in a .pdb file. 詳細については、「/debug (Visual Basic)」を参照してください。For more information, see /debug (Visual Basic).
ErrorReport 省略可能な String 型のパラメーターです。Optional String parameter.

内部コンパイル エラーの報告方法を指定します。Specifies how the task should report internal compiler errors. このパラメーターには、次の値を指定できます。This parameter can have the following values:

- prompt
- send
- none

prompt を指定した場合、内部コンパイラ エラーが発生すると、ユーザーはエラー データを Microsoft に送信するかどうか選択するように求められます。If prompt is specified and an internal compiler error occurs, the user is prompted with an option of wheter to send the error data to Microsoft.

send を指定した場合、内部コンパイラ エラーが発生すると、エラー データが Microsoft に送信されます。If send is specified and an internal compiler error occurs, the task sends the error data to Microsoft.

既定値は none です。テキスト出力のみでエラーが報告されます。The default value is none, which reports errors in text output only.

このパラメーターは、vbc.exe コンパイラの /errorreport スイッチに相当します。This parameter corresponds to the /errorreport switch of the vbc.exe compiler.
FileAlignment 省略可能な Int32 型のパラメーターです。Optional Int32 parameter.

出力ファイルでセクションをアラインするサイズをバイト単位で指定します。Specifies, in bytes, where to align the sections of the output file. このパラメーターには、次の値を指定できます。This parameter can have the following values:

- 512
- 1024
- 2048
- 4096
- 8192

このパラメーターは、vbc.exe コンパイラの /filealign スイッチに相当します。This parameter corresponds to the /filealign switch of the vbc.exe compiler.
GenerateDocumentation 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、ドキュメント情報が生成され、タスクが作成する実行可能ファイルまたはライブラリの名前が与えられた XML ファイルに格納されます。If true, generates documentation information and places it in an XML file with the name of the executable file or library that the task is creating. 詳細については、「/doc」を参照してください。For more information, see /doc.
Imports 省略可能な ITaskItem[] 型のパラメーターです。Optional ITaskItem[] parameter.

指定した項目コレクションから名前空間をインポートします。Imports namespaces from the specified item collections. このパラメーターは、vbc.exe コンパイラの /imports スイッチに相当します。This parameter corresponds to the /imports switch of the vbc.exe compiler.
KeyContainer 省略可能な String 型のパラメーターです。Optional String parameter.

暗号化キー コンテナーの名前を指定します。Specifies the name of the cryptographic key container. このパラメーターは、vbc.exe コンパイラの /keycontainer スイッチに相当します。This parameter corresonds to the /keycontainer switch of the vbc.exe compiler.
KeyFile 省略可能な String 型のパラメーターです。Optional String parameter.

暗号化キーを格納するファイル名を指定します。Specifies the file name containing the cryptographic key. 詳細については、「/keyfile」を参照してください。For more information, see /keyfile.
LangVersion 省略可能な System.String 型のパラメーターです。Optional System.String parameter.

言語バージョンとして "9" か "10" を指定します。Specifies the language version, either "9" or "10".
LinkResources 省略可能な ITaskItem[] 型のパラメーターです。Optional ITaskItem[] parameter.

出力ファイル内で .NET Framework リソースへのリンクを作成します。リソース ファイルは出力ファイル内に置かれません。Creates a link to a .NET Framework resource in the output file; the resource file is not placed in the output file. このパラメーターは、vbc.exe コンパイラの /linkresource スイッチに相当します。This parameter corresponds to the /linkresource switch of the vbc.exe compiler.
MainEntryPoint 省略可能な String 型のパラメーターです。Optional String parameter.

Sub Main プロシージャを格納するクラスまたはモジュールを指定します。Specifies the class or module that contains the Sub Main procedure. このパラメーターは、vbc.exe コンパイラの /main スイッチに相当します。This parameter corresonds to the /main switch of the vbc.exe compiler.
ModuleAssemblyName 省略可能な String 型のパラメーターです。Optional String parameter.

このモジュールが一部となるアセンブリを指定します。Specifies the assembly that this module is a part of.
NoConfig 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

コンパイラで vbc.rsp ファイルを使用しないように指定します。Specifies that the compiler should not use the vbc.rsp file. このパラメーターは、vbc.exe コンパイラの /noconfig パラメーターに相当します。This parameter corresponds to the /noconfig parameter of the vbc.exe compiler.
NoLogo 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、コンパイラの著作権情報が表示されません。If true, suppresses display of compiler banner information. このパラメーターは、vbc.exe コンパイラの /nologo スイッチに相当します。This parameter corresponds to the /nologo switch of the vbc.exe compiler.
NoStandardLib 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

コンパイラが標準ライブラリを参照しないようにします。Causes the compiler not to reference the standard libraries. このパラメーターは、vbc.exe コンパイラの /nostdlib スイッチに相当します。This parameter corresponds to the /nostdlib switch of the vbc.exe compiler.
NoVBRuntimeReference 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

内部使用のみ。Internal use only. true の場合、Microsoft.VisualBasic.dll の自動参照が禁止されます。If true, prevents the automatic reference to Microsoft.VisualBasic.dll..
NoWarnings 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、すべての警告が非表示になります。If true, the task supresses all warnings. 詳しくは、「/nowarn」をご覧ください。For more information, see /nowarn.
Optimize 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、コンパイラ最適化が有効になります。If true, enables compiler optimizations. このパラメーターは、vbc.exe コンパイラの /optimize スイッチに相当します。This parameter corresponds to the /optimize switch of the vbc.exe compiler.
OptionCompare 省略可能な String 型のパラメーターです。Optional String parameter.

文字列比較の方法を指定します。Specifies how string comparisons are made. このパラメーターには、次の値を指定できます。This parameter can have the following values:

- binary
- text

binary を指定すると、バイナリ文字列比較が使用されます。The value binary specifies that the task uses binary string comparisons. text を指定すると、テキスト文字列比較が使用されます。The value text specifies that the task uses text string comparisons. このパラメーターの既定値は、binary です。The default value of this parameter is binary. このパラメーターは、vbc.exe コンパイラの /optioncompare スイッチに相当します。This parameter corresponds to the /optioncompare switch of the vbc.exe compiler.
OptionExplicit 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、変数の明示的宣言が必要になります。If true, explicit declaration of variables is required. このパラメーターは、vbc.exe コンパイラの /optionexplicit スイッチに相当します。This parameter corresponds to the /optionexplicit switch of the vbc.exe compiler.
OptionInfer 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、変数の型推論を許可します。If true, allows type inference of variables.
OptionStrict 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、厳密な型のセマンティックスが強制され、暗黙的な型変換が制限されます。If true, the task enforces strict type semantics to restrict implicit type conversions. このパラメーターは、vbc.exe コンパイラの /optionstrict スイッチに相当します。This parameter corresponds to the /optionstrict switch of the vbc.exe compiler.
OptionStrictType 省略可能な String 型のパラメーターです。Optional String parameter.

警告を生成する厳密な型のセマンティックスを指定します。Specifies which strict type semantics generate a warning. 現在のところ、"custom" のみに対応しています。Currently, only "custom" is supported. このパラメーターは、vbc.exe コンパイラの /optionstrict スイッチに相当します。This parameter corresponds to the /optionstrict switch of the vbc.exe compiler.
OutputAssembly 省略可能な String 型の出力パラメーターです。Optional String output parameter.

出力ファイルの名前を指定します。Specifies the name of the ouput file. このパラメーターは、vbc.exe コンパイラの /out スイッチに相当します。This parameter corresponds to the /out switch of the vbc.exe compiler.
Platform 省略可能な String 型のパラメーターです。Optional String parameter.

出力ファイルのターゲットとするプロセッサ プラットフォームを指定します。Specifies the processor platform to be targeted by the output file. このパラメーターの値には、x86x64Itanium、または anycpu を指定できます。This parameter can have a value of x86, x64, Itanium, or anycpu. 既定値は anycpu です。Default is anycpu. このパラメーターは、vbc.exe コンパイラの /platform スイッチに相当します。This parameter corresponds to the /platform switch of the vbc.exe compiler.
References 省略可能な ITaskItem[] 型のパラメーターです。Optional ITaskItem[] parameter.

指定したアイテムから現在のプロジェクトにパブリック型の情報をインポートするようにタスクに指示します。Causes the task to import public type information from the specified items into the current project. このパラメーターは、vbc.exe コンパイラの /reference スイッチに相当します。This parameter corresponds to the /reference switch of the vbc.exe compiler.
RemoveIntegerChecks 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、整数オーバーフローのエラー チェックを無効にします。If true, disables integer overflow error checks. 既定値は false です。The default value is false. このパラメーターは、vbc.exe コンパイラの /removeintchecks スイッチに相当します。This parameter corresponds to the /removeintchecks switch of the vbc.exe compiler.
Resources 省略可能な ITaskItem[] 型のパラメーターです。Optional ITaskItem[] parameter.

.NET Framework のリソースを出力ファイルに埋め込みます。Embeds a .NET Framework resource into the output file. このパラメーターは、vbc.exe コンパイラの /resource スイッチに相当します。This parameter corresponds to the /resource switch of the vbc.exe compiler.
ResponseFiles 省略可能な ITaskItem[] 型のパラメーターです。Optional ITaskItem[] parameter.

このタスクのコマンドを含む応答ファイルを指定します。Specifies the response file that contains commands for this task. このパラメーターは、vbc.exe コンパイラの @ (Specify Response File) オプションに相当します。This parameter corresponds to the @ (Specify Response File) option of the vbc.exe compiler.
RootNamespace 省略可能な String 型のパラメーターです。Optional String parameter.

すべての型宣言に対してルート名前空間を指定します。Specifies the root namespace for all type declarations. このパラメーターは、vbc.exe コンパイラの /rootnamespace スイッチに相当します。This parameter corresponds to the /rootnamespace switch of the vbc.exe compiler.
SdkPath 省略可能な String 型のパラメーターです。Optional String parameter.

mscorlib.dll および microsoft.visualbasic.dll の位置を指定します。Specifies the location of mscorlib.dll and microsoft.visualbasic.dll. このパラメーターは、vbc.exe コンパイラの /sdkpath スイッチに相当します。This parameter corresponds to the /sdkpath switch of the vbc.exe compiler.
Sources 省略可能な ITaskItem[] 型のパラメーターです。Optional ITaskItem[] parameter.

1 つまたは複数の Visual BasicVisual Basic ソース ファイルを指定します。Specifies one or more Visual BasicVisual Basic source files.
TargetCompactFramework 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、.NET Compact Framework.NET Compact Framework が対象となります。If true, the task targets the .NET Compact Framework.NET Compact Framework. このスイッチは、vbc.exe コンパイラの /netcf スイッチに相当します。This switch corresponds to the /netcf switch of the vbc.exe compiler.
TargetType 省略可能な String 型のパラメーターです。Optional String parameter.

出力ファイルのファイル形式を指定します。Specifies the file format of the output file. このパラメーターには値として、コード ライブラリを作成する library、コンソール アプリケーションを作成する exe、モジュールを作成する module、Windows プログラムを作成する winexe を指定できます。This parameter can have a value of library, which creates a code library, exe, which creates a console application, module, which creates a module, or winexe, which creates a Windows program. 既定値は library です。Default is library. このパラメーターは、vbc.exe コンパイラの /target スイッチに相当します。This parameter corresponds to the /target switch of the vbc.exe compiler.
Timeout 省略可能な Int32 型のパラメーターです。Optional Int32 parameter.

タスク実行を終了するまでの時間をミリ秒単位で指定します。Specifies the amount of time, in milliseconds, after which the task executable is terminated. 既定値は Int.MaxValue であり、タイムアウト期限がないことを示します。The default value is Int.MaxValue, indicating that there is no time out period.
ToolPath 省略可能な String 型のパラメーターです。Optional String parameter.

タスクが基になる実行可能ファイル (vbc.exe) を読み込む場所を指定します。Specifies the location from where the task will load the underlying executable file (vbc.exe). このパラメーターを指定しないと、MSBuildMSBuild を実行しているフレームワークのバージョンに対応する SDK インストール パスがタスクに使用されます。If this parameter is not specified, the task uses the SDK installation path corresponding to the version of the framework that is running MSBuildMSBuild.
TreatWarningsAsErrors 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、すべての警告がエラーとして処理されます。If true, all warnings are treated as errors. 詳細については、「/warnaserror (Visual Basic)」を参照してください。For more information, see /warnaserror (Visual Basic).
UseHostCompilerIfAvailable 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

利用できる場合、インプロセス コンパイラ オブジェクトを使用するようにタスクに指示します。Instructs the task to use the in-process compiler object, if available. Visual StudioVisual Studio によってのみ使用されます。Used only by Visual StudioVisual Studio.
Utf8Output 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

UTF-8 エンコードを使用してコンパイラ出力をログに記録します。Logs compiler output using UTF-8 encoding. このパラメーターは、vbc.exe コンパイラの /utf8output スイッチに相当します。This parameter corresponds to the /utf8output switch of the vbc.exe compiler.
Verbosity 省略可能な String 型のパラメーターです。Optional String parameter.

コンパイラ出力の詳細度を指定します。Specifies the verbosity of the compiler's output. 詳細度は QuietNormal (既定)、または Verbose です。Verbosity can be Quiet, Normal (the default), or Verbose.
WarningsAsErrors 省略可能な String 型のパラメーターです。Optional String parameter.

エラーとして扱う警告の一覧を指定します。Specifies a list of warnings to treat as errors. 詳細については、「/warnaserror (Visual Basic)」を参照してください。For more information, see /warnaserror (Visual Basic).

このパラメーターは TreatWarningsAsErrors パラメーターに優先します。This parameter overrides the TreatWarningsAsErrors parameter.
WarningsNotAsErrors 省略可能な String 型のパラメーターです。Optional String parameter.

エラーとして扱わない警告の一覧を指定します。Specifies a list of warnings that are not treated as errors. 詳細については、「/warnaserror (Visual Basic)」を参照してください。For more information, see /warnaserror (Visual Basic).

このパラメーターは、TreatWarningsAsErrors パラメーターが true に設定されている場合にのみ役に立ちます。This parameter is only useful if the TreatWarningsAsErrors parameter is set to true.
Win32Icon 省略可能な String 型のパラメーターです。Optional String parameter.

エクスプローラーで出力ファイルを適切に表示する .ico ファイルをアセンブリに挿入します。Inserts an .ico file in the assembly, which gives the output file the desired appearance in File Explorer. このパラメーターは、vbc.exe コンパイラの /win32icon スイッチに相当します。This parameter corresponds to the /win32icon switch of the vbc.exe compiler.
Win32Resources 省略可能な String 型のパラメーターです。Optional String parameter.

Win32 リソース (.res) ファイルを出力ファイルに挿入します。Inserts a Win32 resource (.res) file in the output file. このパラメーターは、vbc.exe コンパイラの /win32resource スイッチに相当します。This parameter corresponds to the /win32resource switch of the vbc.exe compiler.

コメントRemarks

上記のパラメーター以外に、このタスクは ToolTaskExtension クラスからパラメーターを継承します。このクラス自体は、ToolTask クラスから継承されます。In addition to the parameters listed above, this task inherits parameters from the ToolTaskExtension class, which itself inherits from the ToolTask class. これらの追加のパラメーターの一覧とその説明については、「ToolTaskExtension 基本クラス」を参照してください。For a list of these additional parameters and their descriptions, see ToolTaskExtension Base Class.

Example

次の例では、Visual BasicVisual Basic プロジェクトがコンパイルされます。The following example compiles a Visual BasicVisual Basic project.

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

参照See Also

Visual Basic のコマンド ライン コンパイラ Visual Basic Command-Line Compiler
タスク Tasks
Task Reference (タスク リファレンス)Task Reference