VCConfiguration.BuildWithProperty, méthode
Commence une génération asynchrone par une propriété donnée définie sur une valeur quelconque au-delà de ce qui est défini dans le fichier de projet.
Espace de noms : Microsoft.VisualStudio.VCProjectEngine
Assembly : Microsoft.VisualStudio.VCProjectEngine (dans Microsoft.VisualStudio.VCProjectEngine.dll)
Syntaxe
'Déclaration
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
)
Paramètres
- bldType
Type : Microsoft.VisualStudio.VCProjectEngine.bldActionTypes
Une des valeurs d'énumération qui spécifie le type de build à démarrer.
- bstrPropertyName
Type : System.String
Nom d'une propriété globale de MSBuild à définir sur le projet avant le démarrage de la génération.
- bstrPropertyValue
Type : System.String
Valeur à affecter à la propriété représentée par le paramètre bstrPropertyName.
- callback
Type : Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback
Fonction de rappel facultative appelée lorsque la génération se termine ; sinon, nullune référence null (Nothing en Visual Basic).
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | Cette méthode est appelée sur un objet d'VCConfiguration qui n'est pas dans la configuration de solution active. ou Une génération est déjà en cours. |
Notes
La génération qui est mise en file d'attente par cette méthode peut ne pas apparaître sur la file d'attente de build du gestionnaire de génération de solution lorsque cette méthode quitte.Les appelants qui doivent attendre la génération pour s'achever doivent attendre sur un thread d'arrière-plan jusqu'à ce que la fonction de rappel soit appelée.Cette tactique évite un interblocage sur le thread principal, qui doit pomper des messages pour démarrer la génération.
La fonction de rappel est appelée, le cas échéant, dès que cet objet d'VCConfiguration finira de générer, qui peut être avant la génération de solution finisse.Cela peut se produire, par exemple, si d'autres générations sont également mises en file d'attente.La fonction de rappel est appelée sur le thread principal.
Un objet d'VCConfiguration peut être uniquement s'il est actuellement actif donné - configuration de solution active générée.
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.