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.
Fait apparaître un événement lorsque des progrès mesurables sont réalisés 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 -> unitPublic 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
Une chaîne qui décrit l’événement de progression qui est lancé.
- percentComplete
- Int32
Un entier utilisé pour indiquer la partie de la tâche accomplie.
- progressCountLow
- Int32
Un entier contenant les 32 bits inférieurs des unités complétées.
- progressCountHigh
- Int32
Un entier qui contient les 32 bits élevés des unités complétées.
- subComponent
- String
Une chaîne contenant plus de détails sur la source de l’événement.
- fireAgain
- Boolean
Un booléen qui indique que cela doit continuer ou cesser de tirer. Une valeur de vrai indique qu’il doit continuer à tirer.
Remarques
Comme 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 tir d’événement possède un FireAgain paramètre. Si la valeur de cette variable est false, après le retour de la méthode, l’appelant ne déclenchera pas cet événement pendant toute la durée de l’exécution en cours.
Plusieurs de ces événements possèdent un subComponent paramètre qui permet une granularité encore plus grande dans l’identification des sources d’événements.