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