WebClient.DownloadStringCompleted Kejadian

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Sumber:

WebClient.cs

Terjadi ketika operasi pengunduhan sumber daya asinkron selesai.

public:
 event System::Net::DownloadStringCompletedEventHandler ^ DownloadStringCompleted;

public event System.Net.DownloadStringCompletedEventHandler? DownloadStringCompleted;

member this.DownloadStringCompleted : System.Net.DownloadStringCompletedEventHandler 

Public Custom Event DownloadStringCompleted As DownloadStringCompletedEventHandler 

Jenis Acara

DownloadStringCompletedEventHandler

Contoh

Contoh kode berikut menunjukkan pengaturan penanganan aktivitas untuk kejadian ini.

// Sample call : DownloadStringInBackground2 ("http://www.contoso.com/GameScores.html");
void DownloadStringInBackground2( String^ address )
{
   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

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

// 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);
}

'  Sample call : DownloadStringInBackground2 ("http:' www.contoso.com/GameScores.html")
Public Shared Sub DownloadStringInBackground2(ByVal address As String)

    Dim client As WebClient = New WebClient()

    '  Specify that the DownloadStringCallback2 method gets called
    '  when the download completes.
    AddHandler client.DownloadStringCompleted, AddressOf DownloadStringCallback2
                Dim uri as Uri = New Uri(address)
    client.DownloadStringAsync(uri)
End Sub

Contoh kode berikut menunjukkan implementasi handler untuk kejadian ini.

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 == nullptr )
   {
      String^ textString = dynamic_cast<String^>(e->Result);
      Console::WriteLine( textString );
   }
}

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);
    }
}

Private Shared Sub DownloadStringCallback2(ByVal sender As Object, ByVal e As DownloadStringCompletedEventArgs)

    '  If the request was not canceled and did not throw
    '  an exception, display the resource.
    If e.Cancelled = False AndAlso e.Error Is Nothing Then

        Dim textString As String = CStr(e.Result)
        Console.WriteLine(textString)
    End If
End Sub

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Kejadian ini dinaikkan setiap kali operasi asinkron untuk mengunduh sumber daya saat string selesai. Operasi ini dimulai dengan memanggil metode DownloadStringAsync.

DownloadStringCompletedEventHandler adalah delegasi untuk peristiwa ini. Kelas DownloadStringCompletedEventArgs menyediakan penanganan aktivitas dengan data peristiwa.

Untuk informasi selengkapnya tentang cara menangani peristiwa, lihat Menangani dan Meningkatkan Peristiwa.