AsyncCompletedEventArgs Classe

Définition

Fournit des données pour l’événement MethodNameCompleted .

public ref class AsyncCompletedEventArgs : EventArgs
public class AsyncCompletedEventArgs : EventArgs
type AsyncCompletedEventArgs = class
    inherit EventArgs
Public Class AsyncCompletedEventArgs
Inherits EventArgs
Héritage
AsyncCompletedEventArgs
Dérivé

Exemples

L’exemple de code suivant illustre l’utilisation d’un AsyncOperation pour suivre la durée de vie des opérations asynchrones. Cet exemple de code fait partie d’un exemple plus grand fourni pour la System.ComponentModel.AsyncOperationManager classe .

using System;
using System.Collections;
using System.Collections.Specialized;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Globalization;
using System.Threading;
using System.Windows.Forms;
Imports System.Collections
Imports System.Collections.Specialized
Imports System.ComponentModel
Imports System.Drawing
Imports System.Globalization
Imports System.Threading
Imports System.Windows.Forms
// This event handler updates the ListView control when the
// PrimeNumberCalculator raises the CalculatePrimeCompleted
// event. The ListView item is updated with the appropriate
// outcome of the calculation: Canceled, Error, or result.
private void primeNumberCalculator1_CalculatePrimeCompleted(
    object sender, 
    CalculatePrimeCompletedEventArgs e)
{
    Guid taskId = (Guid)e.UserState;

    if (e.Cancelled)
    {   
        string result = "Canceled";

        ListViewItem lvi = UpdateListViewItem(taskId, result);

        if (lvi != null)
        {
            lvi.BackColor = Color.Pink;
            lvi.Tag = null;
        }
    }
    else if (e.Error != null)
    {
        string result = "Error";

        ListViewItem lvi = UpdateListViewItem(taskId, result);

        if (lvi != null)
        {
            lvi.BackColor = Color.Red;
            lvi.ForeColor = Color.White;
            lvi.Tag = null;
        }
    }
    else
    {   
        bool result = e.IsPrime;

        ListViewItem lvi = UpdateListViewItem(
            taskId, 
            result, 
            e.FirstDivisor);

        if (lvi != null)
        {
            lvi.BackColor = Color.LightGray;
            lvi.Tag = null;
        }
    }
}
' This event handler updates the ListView control when the
' PrimeNumberCalculator raises the CalculatePrimeCompleted
' event. The ListView item is updated with the appropriate
' outcome of the calculation: Canceled, Error, or result.
Private Sub primeNumberCalculator1_CalculatePrimeCompleted( _
    ByVal sender As Object, _
    ByVal e As CalculatePrimeCompletedEventArgs) _
    Handles primeNumberCalculator1.CalculatePrimeCompleted

    Dim taskId As Guid = CType(e.UserState, Guid)

    If e.Cancelled Then
        Dim result As String = "Canceled"

        Dim lvi As ListViewItem = UpdateListViewItem( _
            taskId, _
            result)

        If (lvi IsNot Nothing) Then
            lvi.BackColor = Color.Pink
            lvi.Tag = Nothing
        End If

    ElseIf e.Error IsNot Nothing Then

        Dim result As String = "Error"

        Dim lvi As ListViewItem = UpdateListViewItem( _
            taskId, result)

        If (lvi IsNot Nothing) Then
            lvi.BackColor = Color.Red
            lvi.ForeColor = Color.White
            lvi.Tag = Nothing
        End If
    Else
        Dim result As Boolean = e.IsPrime

        Dim lvi As ListViewItem = UpdateListViewItem( _
            taskId, _
            result, _
            e.FirstDivisor)

        If (lvi IsNot Nothing) Then
            lvi.BackColor = Color.LightGray
            lvi.Tag = Nothing
        End If
    End If

End Sub

Remarques

Si vous utilisez une classe qui implémente la vue d’ensemble du modèle asynchrone basé sur les événements, la classe fournit un événement MethodNameCompleted . Si vous ajoutez une instance du System.ComponentModel.AsyncCompletedEventHandler délégué à l’événement, vous recevrez des informations sur le résultat des opérations asynchrones dans le AsyncCompletedEventArgs paramètre de la méthode de gestionnaire d’événements correspondante.

Le délégué du gestionnaire d’événements de l’application cliente peut case activée la Cancelled propriété pour déterminer si la tâche asynchrone a été annulée.

Le délégué gestionnaire d’événements de l’application cliente peut case activée la Error propriété pour déterminer si une exception s’est produite pendant l’exécution de la tâche asynchrone.

Si la classe prend en charge plusieurs méthodes asynchrones ou plusieurs appels à la même méthode asynchrone, vous pouvez déterminer quelle tâche a déclenché l’événement MethodNameCompleted en vérifiant la valeur de la UserState propriété . Votre code doit suivre ces jetons, appelés ID de tâche, lorsque les tâches asynchrones correspondantes démarrent et se terminent.

Notes pour les héritiers

Les classes qui suivent le modèle asynchrone basé sur les événements peuvent déclencher des événements pour alerter les clients sur la status des opérations asynchrones en attente. Si la classe fournit un événement MethodNameCompleted , vous pouvez utiliser pour informer les AsyncCompletedEventArgs clients du résultat des opérations asynchrones.

Vous souhaiterez peut-être communiquer aux clients plus d’informations sur le résultat d’une opération asynchrone qu’une prise en AsyncCompletedEventArgs charge. Dans ce cas, vous pouvez dériver votre propre classe de la AsyncCompletedEventArgs classe et fournir des variables de instance privées supplémentaires et des propriétés publiques en lecture seule correspondantes. Appelez la RaiseExceptionIfNecessary() méthode avant de retourner la valeur de la propriété, au cas où l’opération a été annulée ou si une erreur s’est produite.

Constructeurs

AsyncCompletedEventArgs()
Obsolète.

Initialise une nouvelle instance de la classe AsyncCompletedEventArgs.

AsyncCompletedEventArgs(Exception, Boolean, Object)

Initialise une nouvelle instance de la classe AsyncCompletedEventArgs.

Propriétés

Cancelled

Obtient une valeur qui indique si une opération asynchrone a été annulée.

Error

Obtient une valeur qui indique quelle erreur s'est produite pendant une opération asynchrone.

UserState

Obtient l'identificateur unique de la tâche asynchrone.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
RaiseExceptionIfNecessary()

Lève une exception fournie par l'utilisateur en cas d'échec d'une opération asynchrone.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi