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.bldActionTypesUne des valeurs d'énumération qui spécifie le type de build à démarrer.
bstrPropertyName
Type : StringNom d'une propriété globale de MSBuild à définir sur le projet avant le démarrage de la génération.
bstrPropertyValue
Type : StringValeur à affecter à la propriété représentée par le paramètre bstrPropertyName.
callback
Type : Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallbackFonction 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 VCConfiguration qui n'est pas dans la configuration de la solution active. ou Une génération est déjà en cours. |
Notes
La génération qui est en attente par cette méthode ne peut pas apparaître dans la file d'attente de build du gestionnaire de génération de solution cette méthode se termine. Les appelants doivent attendre la génération de l'exécution doivent attendre sur un thread d'arrière-plan jusqu'à ce que la fonction de rappel est appelé. Cette tactique évite un blocage sur le thread principal, qui doit pomper des messages pour démarrer la génération.
La fonction de rappel est appelé, le cas échéant, dès que cet objet d'VCConfiguration se termine de générer, qui peut être avant la génération de solution terminée. Cela peut se produire, par exemple, si d'autres versions sont également mises en file d'attente. La fonction de rappel est appelée sur le thread principal.
Objet d'VCConfiguration peut être uniquement s'il peut actuellement actif - configuration de la solution active établie.
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, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.