Metoda VCConfiguration.BuildWithProperty —
Asynchroniczne build zaczyna się od danej właściwości ustawiona na pewną wartość, poza co to jest zdefiniowany w pliku projektu.
Przestrzeń nazw: Microsoft.VisualStudio.VCProjectEngine
Zestaw: Microsoft.VisualStudio.VCProjectEngine (w Microsoft.VisualStudio.VCProjectEngine.dll)
Składnia
'Deklaracja
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
)
Parametry
- bldType
Typ: Microsoft.VisualStudio.VCProjectEngine.bldActionTypes
Jedna z wartości wyliczenia, które określa typ kompilacji, aby rozpocząć.
- bstrPropertyName
Typ: System.String
Nazwa MSBuild właściwość globalna ustawić przed rozpoczęciem budowanie projektu.
- bstrPropertyValue
Typ: System.String
Wartość, aby ustawić właściwość, reprezentowana przez bstrPropertyName parametru.
- callback
Typ: Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback
Funkcja wywołania zwrotnego opcjonalne, wywoływana po zakończeniu budowy; w przeciwnym razie nullodwołanie o wartości null (Nothing w języku Visual Basic).
Wyjątki
Wyjątek | Warunek |
---|---|
InvalidOperationException | Ta metoda jest wywoływana w VCConfiguration obiekt, który nie znajduje się w konfiguracji aktywny rozwiązania. - lub - Kompilacja jest już w toku. |
Uwagi
Kompilacji, który znajduje się w kolejce przez tę metodę mogą być niewidoczne w kolejce build Menedżera zbudować roztwór, kiedy ta metoda.Wywoływania, które trzeba poczekać kompilacji do ukończenia powinien czekać na wątek tła, dopóki nie zostanie wywołana funkcja wywołania zwrotnego.Takie działanie pozwala na uniknięcie zakleszczenia w głównym wątku, który musi pompy wiadomości, aby rozpocząć budowanie.
Funkcja wywołania zwrotnego, jeżeli występuje, nazywa się tak szybko jak to VCConfiguration obiektu Wykończenie budynku, który może być przed roztwór kompilacji wykończenia.Może to się zdarzyć na przykład, jeśli inne kompilacje również są umieszczane w kolejce.W głównym wątku, wywoływana jest funkcja wywołania zwrotnego.
A VCConfiguration obiekt może być budowany tylko wtedy, gdy jest aktywny przy konfiguracji rozwiązania aktualnie aktywne.
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..