IDTSComponentEvents.FireProgress Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Déclenche un événement lorsqu'une progression quantifiable a été réalisée par l'exécutable.
public:
void FireProgress(System::String ^ progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, System::String ^ subComponent, bool % fireAgain);
public void FireProgress (string progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, string subComponent, ref bool fireAgain);
abstract member FireProgress : string * int * int * int * string * bool -> unit
Public Sub FireProgress (progressDescription As String, percentComplete As Integer, progressCountLow As Integer, progressCountHigh As Integer, subComponent As String, ByRef fireAgain As Boolean)
Paramètres
- progressDescription
- String
Chaîne qui décrit l’événement de progression déclenché.
- percentComplete
- Int32
Entier utilisé pour indiquer la quantité de la tâche terminée.
- progressCountLow
- Int32
Entier qui contient les 32 bits faibles des unités terminées.
- progressCountHigh
- Int32
Entier qui contient les 32 bits élevés des unités terminées.
- subComponent
- String
Valeur String qui contient des détails supplémentaires à propos de la source de l'événement.
- fireAgain
- Boolean
Valeur booléenne qui indique que cela doit continuer à déclencher ou arrêter le déclenchement. La valeur true indique qu’elle doit continuer à déclencher.
Remarques
Étant donné que le déclenchement d’un événement peut être coûteux, le moteur d’exécution fournit un mécanisme pour supprimer les événements qui ne vous intéressent pas. Chaque méthode de déclenchement d’événements a un FireAgain
paramètre. Si la valeur de cette variable est false
, une fois la méthode retournée, l’appelant ne déclenche pas à nouveau cet événement pendant la durée de l’exécution actuelle.
Plusieurs des événements ont un paramètre qui permet une subComponent
granularité encore plus grande dans l’identification de la source d’événements.