VCConfiguration.BuildAndCallback メソッド
この構成の同期ビルドを開始します。
名前空間: Microsoft.VisualStudio.VCProjectEngine
アセンブリ: Microsoft.VisualStudio.VCProjectEngine (Microsoft.VisualStudio.VCProjectEngine.dll 内)
構文
'宣言
Sub BuildAndCallback ( _
buildType As bldActionTypes, _
callback As IVCBuildCompleteCallback _
)
void BuildAndCallback(
bldActionTypes buildType,
IVCBuildCompleteCallback callback
)
void BuildAndCallback(
[InAttribute] bldActionTypes buildType,
[InAttribute] IVCBuildCompleteCallback^ callback
)
abstract BuildAndCallback :
buildType:bldActionTypes *
callback:IVCBuildCompleteCallback -> unit
function BuildAndCallback(
buildType : bldActionTypes,
callback : IVCBuildCompleteCallback
)
パラメーター
- buildType
型 : Microsoft.VisualStudio.VCProjectEngine.bldActionTypes
開始するビルドの種類を指定する列挙値の 1 つ。
- callback
型 : Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback
ビルドが終了するときに呼び出されるオプションのコールバック関数。それ以外の場合は nullnull 参照 (Visual Basic では Nothing)。
例外
| 例外 | 条件 |
|---|---|
| InvalidOperationException | このメソッドは、アクティブなソリューション構成にない VCConfiguration オブジェクトによって呼び出されます。 または ビルドは既に実行中です。 |
解説
このメソッドは、以前のリリースをサポートするために存在し、Visual Studio の外部でビルドを行います。Visual Studio 内のツールは、ソリューション ビルド マネージャーを使用してビルドを開始する必要があります。
このメソッドが終了したとき、このメソッドによってキューに置かれているビルドは、ソリューション ビルド マネージャーのビルド キューに表示されない場合があります。ビルドの完了を待機する必要がある呼び出し側は、コールバック関数が呼び出されるまでバックグラウンド スレッドで待機する必要があります。この方法により、メイン スレッド上のデッドロックを回避できるため、メッセージ ポンプ処理が行われ、ビルドが開始するはずです。
コールバック関数が用意されている場合、この VCConfiguration オブジェクトが構築を完了すると、すぐに関数が呼び出されます。ソリューション ビルドが完了する前になる可能性があります。これは、たとえば、他のビルドもキューに追加されている場合に起こります。コールバック関数は メイン スレッドで呼び出されます。
VCConfiguration オブジェクトは、現在アクティブなソリューション構成が指定されてアクティブな場合にのみ作成できます。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。