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
一個列舉值,指定要啟動的建置類型。
- bstrPropertyName
型別:System.String
建置開始之前要在專案上設定的 MSBuild 全域屬性的名稱。
- bstrPropertyValue
型別:System.String
要在 bstrPropertyName 參數所表示的屬性上設定的值。
- callback
型別:Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback
建置完成時叫用的選擇性回呼函數;否則為 nullnull 參考 (即 Visual Basic 中的 Nothing)。
例外狀況
例外狀況 | 條件 |
---|---|
InvalidOperationException | 這個方法會在叫用VCConfiguration不在作用中方案組態中的物件。 -或- 建置已經在進行中。 |
備註
這個方法結束時的組建會排入佇列,這個方法可能不會顯示組建佇列的方案建置管理員。必須等到建置完成的呼叫端應該等候背景執行緒上呼叫回呼函式。這個策略可以避免死結的主執行緒,必須提示來啟動組建的郵件上。
回呼函式,如果有提供,儘快這稱為VCConfiguration物件完成建置,這可能是之前的方案組建完成。這可能會發生,例如,如果其他的組建也會排入佇列。主執行緒上叫用回呼函式。
A VCConfiguration為作用中授與目前使用中的方案組態時,才可以建置的物件。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。