VCConfiguration.BuildWithProperty-Methode

Startet einen asynchronen Build mit einer angegebenen Eigenschaft, die zusätzlich zu den Werten in der Projektdatei festgelegt wurde.

Namespace:  Microsoft.VisualStudio.VCProjectEngine
Assembly:  Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)

Syntax

'Declaration
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
)

Parameter

• bldType
  Typ: Microsoft.VisualStudio.VCProjectEngine.bldActionTypes

  Einer der Enumerationswerte, der den Typ des zu startenden Build angibt.

• bstrPropertyName
  Typ: String

  Der Name einer globalen MSBuild-Eigenschaft, die für das Projekt festgelegt werden soll, bevor der Build gestartet wird.

• bstrPropertyValue
  Typ: String

  Ein Wert, der für die im bstrPropertyName-Parameter angegebene Eigenschaft festgelegt werden soll.

• callback
  Typ: Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback

  Eine optionale Rückruffunktion, die aufgerufen wird, wenn der Build beendet wird, andernfalls nullein Nullverweis (Nothing in Visual Basic).

Ausnahmen

Ausnahme	Bedingung
InvalidOperationException	Diese Methode wird in einem VCConfiguration-Objekt aufgerufen, das nicht in der aktiven Projektmappenkonfiguration ist. - oder - Ein Buildvorgang wird bereits ausgeführt.

Hinweise

Der Build, der dadurch in die Warteschlange gestellt wird, wird möglicherweise nicht in der Buildwarteschlange des Projektmappenbuild-Managers, wenn diese Methode beendet. Aufrufer, die auf den Build gewartet müssen, indem es, sollten in einem Hintergrundthread warten, bis die Rückruffunktion aufgerufen wird. Diese Zum vermeidet einen Deadlock auf den Hauptthread, der Meldungen zeitlich verschieben muss, um den Build zu starten.

Die Rückruffunktion, wenn, vorausgesetzt, aufgerufen wird, sobald das VCConfiguration-Objekt beendet zu erstellen, das möglicherweise kann, bevor der Projektmappenbuild beendet. Dieser Fall kann beispielsweise andere Builds auch in die Warteschlange gestellt werden. Die Rückruffunktion wird im Hauptthread aufgerufen.

Ein VCConfiguration-Objekt kann aufgebaute nur auf aktives vorgegebenes ist derzeit aktive Projektmappenkonfiguration sein.

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

VCConfiguration Schnittstelle

Microsoft.VisualStudio.VCProjectEngine-Namespace