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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。