WebClient.DownloadStringCompleted Evento

Definizione

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

public event System.Net.DownloadStringCompletedEventHandler? DownloadStringCompleted;
public event System.Net.DownloadStringCompletedEventHandler DownloadStringCompleted;

Tipo evento

Esempio

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

// Sample call : DownloadStringInBackground2 ("http://www.contoso.com/GameScores.html");
public static void DownloadStringInBackground2(string address)
{
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    // Specify that the DownloadStringCallback2 method gets called
    // when the download completes.
    client.DownloadStringCompleted += new DownloadStringCompletedEventHandler(DownloadStringCallback2);
    client.DownloadStringAsync(uri);
}

Nell'esempio di codice seguente viene illustrata un'implementazione di un gestore per questo evento.

private static void DownloadStringCallback2(Object sender, DownloadStringCompletedEventArgs e)
{
    // If the request was not canceled and did not throw
    // an exception, display the resource.
    if (!e.Cancelled && e.Error == null)
    {
        string textString = (string)e.Result;

        Console.WriteLine(textString);
    }
}

Commenti

Attenzione

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

Questo evento viene generato ogni volta che un'operazione asincrona per scaricare una risorsa come stringa viene completata. Queste operazioni vengono avviate chiamando i metodi di DownloadStringAsync.

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

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

Si applica a

Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1