Metodo VCConfiguration.BuildWithProperty
Inizia una compilazione asincrona con una proprietà specificata impostata su un valore superiore a quello definito nel file di progetto.
Spazio dei nomi: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)
Sintassi
'Dichiarazione
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
)
Parametri
- bldType
Tipo: Microsoft.VisualStudio.VCProjectEngine.bldActionTypes
Uno dei valori di enumerazione che specifica il tipo di compilazione da avviare.
- bstrPropertyName
Tipo: System.String
Il nome del controllo MSBuild la proprietà globale da impostare nel progetto prima dell'inizio della compilazione.
- bstrPropertyValue
Tipo: System.String
Un valore da impostare nella proprietà rappresentata da bstrPropertyName parametro.
- callback
Tipo: Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback
Una funzione di callback facoltativa richiamata al termine della compilazione; in caso contrario, nullriferimento null (Nothing in Visual Basic).
Eccezioni
| Eccezione | Condizione |
|---|---|
| InvalidOperationException | Questo metodo viene richiamato su un oggetto VCConfiguration l'oggetto che non si trova in una configurazione di soluzione attiva. - oppure- Una compilazione è già in corso. |
Note
La compilazione viene accodata con questo metodo non venga visualizzato nella coda di compilazione amministratore di processo di compilazione della soluzione quando questo metodo si chiude l'applicazione.I chiamanti che devono attendere la compilazione per completare devono attendere su un thread in background finché non viene chiamato la funzione di callback.Questa tattica evita un deadlock nel thread principale, che distribuisca i messaggi per avviare la compilazione.
La funzione di callback, se incluso, viene chiamata non questo semplice VCConfiguration l'oggetto termine della compilazione, che potrebbe essere prima che il processo di compilazione della soluzione completi.Questa situazione può verificarsi, ad esempio, se altre compilazioni vengono accodate.La funzione di callback richiamata sul thread principale.
In VCConfiguration l'oggetto può essere solo se è attualmente fornito attivo - configurazione di soluzione attiva compilata.
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.