DownloadDataCompletedEventHandler Délégué

Définition

Espace de noms:

System.Net

Assemblys:

netstandard.dll, System.Net.WebClient.dll

Représente la méthode qui gérera l'événement DownloadDataCompleted d'un WebClient.

C#

public delegate void DownloadDataCompletedEventHandler(object sender, DownloadDataCompletedEventArgs e);

Paramètres

sender

Object

Source de l'événement.

e

DownloadDataCompletedEventArgs

DownloadDataCompletedEventArgs contenant les données d’événement.

Exemples

L’exemple de code suivant illustre le téléchargement d’une ressource spécifiée par l’utilisateur.

C#

// Sample call : DownLoadDataInBackground ("http://www.contoso.com/GameScores.html");
public static void DownloadDataInBackground(string address)
{
    System.Threading.AutoResetEvent waiter = new System.Threading.AutoResetEvent(false);
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    // Specify that the DownloadDataCallback method gets called
    // when the download completes.
    client.DownloadDataCompleted += new DownloadDataCompletedEventHandler(DownloadDataCallback);
    client.DownloadDataAsync(uri, waiter);

    // Block the main application thread. Real applications
    // can perform other tasks while waiting for the download to complete.
    waiter.WaitOne();
}

La méthode suivante est appelée une fois le téléchargement terminé.

C#

private static void DownloadDataCallback(Object sender, DownloadDataCompletedEventArgs e)
{
    System.Threading.AutoResetEvent waiter = (System.Threading.AutoResetEvent)e.UserState;

    try
    {
        // If the request was not canceled and did not throw
        // an exception, display the resource.
        if (!e.Cancelled && e.Error == null)
        {
            byte[] data = (byte[])e.Result;
            string textData = System.Text.Encoding.UTF8.GetString(data);

            Console.WriteLine(textData);
        }
    }
    finally
    {
        // Let the main application thread resume.
        waiter.Set();
    }
}

Remarques

Lorsque vous créez un délégué DownloadDataCompletedEventHandler, vous identifiez la méthode qui gérera l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués du gestionnaire d’événements, consultez Gestion et déclenchement d’événements.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

S’applique à