Vbc タスク
更新 : 2007 年 11 月
実行可能ファイル (.exe)、ダイナミック リンク ライブラリ (.dll)、またはコード モジュール (.netmodule) を作成する vbc.exe をラップします。vbc.exe の詳細については、「Visual Basic コンパイラ」を参照してください。
パラメータ
Vbc タスクのパラメータの説明を次の表に示します。
パラメータ |
説明 |
|---|---|
AdditionalLibPaths |
省略可能な String[] 型のパラメータです。 References 属性で指定されたアセンブリを検索する追加のフォルダを指定します。 |
AddModules |
省略可能な String[] 型のパラメータです。 指定ファイルからのすべての型情報をコンパイル中のプロジェクトで使用できるようにします。このパラメータは、vbc.exe コンパイラの /addmodule スイッチに相当します。 |
BaseAddress |
省略可能な String 型のパラメータです。 ダイナミック リンク ライブラリ (DLL: Dynamic Link Library) のベース アドレスを指定します。このパラメータは、vbc.exe コンパイラの /baseaddress スイッチに相当します。 |
CodePage |
省略可能な Int32 型のパラメータです。 コンパイルですべてのソース コード ファイルに使用するコード ページを指定します。このパラメータは、vbc.exe コンパイラの /codepage スイッチに相当します。 |
DebugType |
省略可能な String[] 型のパラメータです。 コンパイラでデバッグ情報が生成されます。このパラメータには、次の値を指定できます。
既定値は、実行中のプログラムにデバッガをアタッチできる full です。pdbonly を指定すると、プログラムがデバッガで開始されたときにはソース コードをデバッグできますが、実行中のプログラムをデバッガにアタッチしたときはアセンブリ言語コードしか表示されません。詳細については、「/debug (Visual Basic)」を参照してください。 |
DefineConstants |
省略可能な String[] 型のパラメータです。 条件付きコンパイル定数を定義します。シンボルと値のペアを、セミコロン (;) で区切って、次の構文で指定します。 symbol1=value1;symbol2=value2 このパラメータは、vbc.exe コンパイラの /define スイッチに相当します。 |
DelaySign |
省略可能な Boolean 型のパラメータです。 true に設定すると、アセンブリに公開キーが格納されます。false に設定すると、アセンブリに完全な署名が行われます。既定値は false です。このパラメータは、KeyFile パラメータまたは KeyContainer パラメータと一緒に使用しない場合は無効になります。このパラメータは、vbc.exe コンパイラの /delaysign スイッチに相当します。 |
DisabledWarnings |
省略可能な String 型のパラメータです。 指定された警告の出力を抑制します。必要なのは、警告 ID の数値を指定することだけです。複数の警告を指定するときは、セミコロン (;) で区切ります。このパラメータは、vbc.exe コンパイラの /nowarn スイッチに相当します。 |
DocumentationFile |
省略可能な String 型のパラメータです。 ドキュメント コメントを指定された XML ファイルに出力します。このパラメータを指定すると、GenerateDocumentation 属性がオーバーライドされます。詳細については、「/doc」を参照してください。 |
EmitDebugInformation |
省略可能な Boolean 型のパラメータです。 true に設定すると、デバッグ情報が生成され、.pdb ファイルに置かれます。詳細については、「/debug (Visual Basic)」を参照してください。 |
ErrorReport |
省略可能な String 型のパラメータです。 タスクで内部コンパイル エラーを報告するかどうかを指定します。このパラメータには、次の値を指定できます。
prompt を指定すると、内部コンパイル エラーが発生した場合に、エラー データをマイクロソフトに送信するかどうかを確認するメッセージが表示されます。 send を指定すると、内部コンパイル エラーが発生した場合に、このタスクによってエラー データがマイクロソフトに送信されます。 既定値は、none です。この場合、エラーはテキストが出力されるだけです。 このパラメータは、vbc.exe コンパイラの /errorreport スイッチに相当します。 |
FileAlignment |
省略可能な Int32 型のパラメータです。 出力ファイルでセクションを揃えるサイズをバイト単位で指定します。このパラメータには、次の値を指定できます。
このパラメータは、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 です。このパラメータは、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[] 型のパラメータです。 1 つ以上の Visual Basic ソース ファイルを指定します。 |
TargetCompactFramework |
省略可能な Boolean 型のパラメータです。 true を設定すると、.NET Compact Framework がこのタスクのターゲットになります。このパラメータは、vbc.exe コンパイラの /netcf スイッチに相当します。 |
TargetType |
省略可能な String 型のパラメータです。 出力ファイルのファイル形式を指定します。このパラメータに指定できる値は、コード ライブラリを作成するための library、コンソール アプリケーションを作成するための exe、モジュールを作成するための module、および、Windows プログラムを作成するための winexe のいずれかです。既定値は library です。このパラメータは、vbc.exe コンパイラの /target スイッチに相当します。 |
Timeout |
省略可能な Int32 型のパラメータです。 タスク実行を終了するまでの時間をミリ秒の単位で指定します。既定値は Int.MaxValue であり、タイムアウト期限がないことを示します。 |
ToolPath |
省略可能な String 型のパラメータです。 基になる実行可能ファイル (vbc.exe) を読み込む場所を指定します。このパラメータを指定しないと、MSBuild を実行しているフレームワークのバージョンに対応する 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 ファイルを挿入します。.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"/>