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: String

  Nome di una proprietà globale di MSBuild da impostare nel progetto prima dell'inizio della compilazione.

• bstrPropertyValue
  Tipo: String

  Valore da impostare nella proprietà rappresentata dal parametro bstrPropertyName.

• callback
  Tipo: Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback

  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 che non si trova nella configurazione di soluzione attiva. - oppure - È già in corso una compilazione.

Note

La compilazione viene accodata con questo metodo non venga visualizzato nella coda di compilazione gestione di processo di compilazione della soluzione quando questo metodo viene chiuso. I chiamanti che devono attendere la compilazione per completare devono attendere su un thread in background non viene chiamata 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 disponibile, viene chiamata non appena questo oggetto di VCConfiguration completa compilare, che potrebbe essere prima che il processo di compilazione della soluzione completi. Ciò può verificarsi, ad esempio, se altre compilazioni vengono accodate. La funzione di callback viene richiamato il thread principale.

Un oggetto di VCConfiguration può essere solo se viene fornito attualmente attiva configurazione di soluzione attiva viene compilata.

Sicurezza di .NET Framework

• Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

VCConfiguration Interfaccia

Spazio dei nomi Microsoft.VisualStudio.VCProjectEngine