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: System.String
  Der Name einer globalen MSBuild-Eigenschaft, die für das Projekt festgelegt werden soll, bevor der Build gestartet wird.

• bstrPropertyValue
  Typ: System.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

Hinweise

Der Build, die von dieser Methode in die Warteschlange gestellt wurde, wird möglicherweise nicht in der Buildwarteschlange des Projektmappenbuild-Managers, wenn diese Methode beendet.Aufrufer, die für den Build warten müssen, sollten auf einen Hintergrundthread warten, bis die Rückruffunktion aufgerufen wird.Diese Taktik einen Deadlock vermieden werden im Hauptthread, der Meldungen pumpen muss, damit der Build gestartet wird.

Die Rückruffunktion, wenn er angegeben wird, aufgerufen wird, sobald diese VCConfiguration-Objekt zu erstellen, das möglicherweise beendet ist, bevor der Projektmappenbuild beendet.Dies kann der Fall sein, z. B. wenn auch weitere Builds in die Warteschlange gestellt werden.Die Rückruffunktion wird im Hauptthread aufgerufen.

Ein Objekt kann nur VCConfiguration aufgebaute wenn es aktiv ist derzeit eine bestimmte Konfiguration der aktuellen Projektmappe befinden.

.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