VCConfiguration.BuildWithProperty(bldActionTypes, String, String, IVCBuildCompleteCallback) Methode

Definition

Startet einen asynchronen Build, wobei eine angegebene Eigenschaft auf einen Wert festgelegt ist, der über den in der Projektdatei definierten Wert hinausgeht.

public:
 void BuildWithProperty(Microsoft::VisualStudio::VCProjectEngine::bldActionTypes bldType, System::String ^ bstrPropertyName, System::String ^ bstrPropertyValue, Microsoft::VisualStudio::VCProjectEngine::IVCBuildCompleteCallback ^ callback);
public:
 void BuildWithProperty(Microsoft::VisualStudio::VCProjectEngine::bldActionTypes bldType, Platform::String ^ bstrPropertyName, Platform::String ^ bstrPropertyValue, Microsoft::VisualStudio::VCProjectEngine::IVCBuildCompleteCallback ^ callback);
void BuildWithProperty(Microsoft::VisualStudio::VCProjectEngine::bldActionTypes bldType, std::wstring const & bstrPropertyName, std::wstring const & bstrPropertyValue, Microsoft::VisualStudio::VCProjectEngine::IVCBuildCompleteCallback const & callback);
[System.Runtime.InteropServices.DispId(786)]
public void BuildWithProperty (Microsoft.VisualStudio.VCProjectEngine.bldActionTypes bldType, string bstrPropertyName, string bstrPropertyValue, Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback callback);
[<System.Runtime.InteropServices.DispId(786)>]
abstract member BuildWithProperty : Microsoft.VisualStudio.VCProjectEngine.bldActionTypes * string * string * Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback -> unit
Public Sub BuildWithProperty (bldType As bldActionTypes, bstrPropertyName As String, bstrPropertyValue As String, callback As IVCBuildCompleteCallback)

Parameter

bldType
bldActionTypes

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

bstrPropertyName
String

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

bstrPropertyValue
String

Ein Wert, der für die Eigenschaft festgelegt werden soll, die durch den Parameter bstrinpropertyname dargestellt wird.

callback
IVCBuildCompleteCallback

Eine optionale Rückruffunktion, die aufgerufen wird, wenn der Build abgeschlossen ist. andernfalls null .

Attribute

Ausnahmen

Diese Methode wird für ein- VCConfiguration Objekt aufgerufen, das nicht in der aktiven Projektmappenkonfiguration ist.

- oder - Ein Build wird bereits ausgeführt.

Hinweise

Der von dieser Methode angezeigte Build wird möglicherweise nicht in der Buildwarteschlange des Projektmappenbuild-Managers angezeigt, wenn diese Methode beendet wird. Aufrufer, die auf den Abschluss des Builds warten müssen, sollten auf einen Hintergrund Thread warten, bis die Rückruffunktion aufgerufen wird. Diese Taktik vermeidet einen Deadlock im Haupt Thread, der Nachrichten zum Starten des Builds verschieben muss.

Wenn die Rückruffunktion bereitgestellt wird, wird Sie aufgerufen, sobald VCConfiguration die Erstellung dieses Objekts abgeschlossen ist. Dies kann vor der Fertigstellung des Projektmappenbuilds sein. Dies kann z. b. der Fall sein, wenn andere Builds in die Warteschlange eingereiht werden. Die Rückruffunktion wird im Haupt Thread aufgerufen.

Ein- VCConfiguration Objekt kann nur erstellt werden, wenn es bei der derzeit aktiven Projektmappenkonfiguration aktiv ist.

Gilt für