WebClient.DownloadFileCompleted Evento

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Origine:

WebClient.cs

Si verifica quando viene completata un'operazione di download di file asincrona.

public:
 event System::ComponentModel::AsyncCompletedEventHandler ^ DownloadFileCompleted;

public event System.ComponentModel.AsyncCompletedEventHandler? DownloadFileCompleted;

member this.DownloadFileCompleted : System.ComponentModel.AsyncCompletedEventHandler 

Public Custom Event DownloadFileCompleted As AsyncCompletedEventHandler 

Tipo evento

AsyncCompletedEventHandler

Esempio

Nell'esempio di codice seguente viene illustrata l'impostazione di un gestore eventi per l'evento DownloadFileCompleted.

// Sample call : DownLoadFileInBackground2 ("http://www.contoso.com/logs/January.txt");
void DownLoadFileInBackground2( String^ address )
{
   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

   // Call DownloadFileCallback2 when the download completes.
   client->DownloadFileCompleted += gcnew AsyncCompletedEventHandler( DownloadFileCallback2 );

   // Specify a progress notification handler here...

   client->DownloadFileAsync( uri, "serverdata.txt" );
}

void DownloadFileCallback2( Object^ /*sender*/, System::ComponentModel::AsyncCompletedEventArgs^ e )
{
   if ( e->Cancelled )
   {
      Console::WriteLine( "File download cancelled." );
   }

   if ( e->Error != nullptr )
   {
      Console::WriteLine( e->Error->ToString() );
   }
}

// Sample call : DownLoadFileInBackground2 ("http://www.contoso.com/logs/January.txt");
public static void DownLoadFileInBackground2(string address)
{
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    // Call DownloadFileCallback2 when the download completes.
    client.DownloadFileCompleted += new AsyncCompletedEventHandler(DownloadFileCallback2);

    // Specify a progress notification handler here ...

    client.DownloadFileAsync(uri, "serverdata.txt");
}

private static void DownloadFileCallback2(object sender, AsyncCompletedEventArgs e)
{
    if (e.Cancelled)
    {
        Console.WriteLine("File download cancelled.");
    }

    if (e.Error != null)
    {
        Console.WriteLine(e.Error.ToString());
    }
}

' Sample call : DownLoadFileInBackground2 ("http:' www.contoso.com/logs/January.txt")
Public Shared Sub DownLoadFileInBackground2(address As String)

    Dim client As WebClient = New WebClient()

    ' Call DownloadFileCallback2 when the download completes.
    AddHandler client.DownloadFileCompleted, AddressOf DownloadFileCallback2

    ' Specify a progress notification handler here...

    Dim uri as Uri = New Uri(address)
    client.DownloadFileAsync(uri, "serverdata.txt")
End Sub

Private Shared Sub DownloadFileCallback2(sender As Object, e As AsyncCompletedEventArgs)
    If e.Cancelled = True Then
        Console.WriteLine("File download cancelled.")
    End If

    If Not e.Error Is Nothing Then
        Console.WriteLine(e.Error.ToString())
    End If
End Sub

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Questo evento viene generato ogni volta che viene completata un'operazione di download di file asincrona. I download di file asincroni vengono avviati chiamando i metodi di DownloadFileAsync.

Il AsyncCompletedEventHandler è il delegato per questo evento. La classe AsyncCompletedEventArgs fornisce al gestore eventi i dati dell'evento.

Per altre informazioni su come gestire gli eventi, vedere Gestione e generazione di eventi.