VCConfiguration.BuildWithProperty(bldActionTypes, String, String, IVCBuildCompleteCallback) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.