WebClient.OpenReadCompleted Zdarzenie

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Źródło:

WebClient.cs

Występuje, gdy operacja asynchroniczna w celu otwarcia strumienia zawierającego zasób zostanie ukończona.

public:
 event System::Net::OpenReadCompletedEventHandler ^ OpenReadCompleted;

public event System.Net.OpenReadCompletedEventHandler? OpenReadCompleted;

member this.OpenReadCompleted : System.Net.OpenReadCompletedEventHandler 

Public Custom Event OpenReadCompleted As OpenReadCompletedEventHandler 

Typ zdarzenia

OpenReadCompletedEventHandler

Przykłady

W poniższym przykładzie kodu pokazano ustawienie procedury obsługi zdarzeń dla tego zdarzenia.

void OpenResourceForReading2( String^ address )
{
   WebClient^ client = gcnew WebClient;
   Uri ^uri = gcnew Uri(address);

   client->OpenReadCompleted += gcnew OpenReadCompletedEventHandler( OpenReadCallback2 );
   client->OpenReadAsync( uri );
}

public static void OpenResourceForReading2(string address)
{
    WebClient client = new WebClient();
    Uri uri = new Uri(address);

    client.OpenReadCompleted += new OpenReadCompletedEventHandler(OpenReadCallback2);
    client.OpenReadAsync(uri);
}

Public Shared Sub OpenResourceForReading2(ByVal address As String)

    Dim client As WebClient = New WebClient()
    AddHandler client.OpenReadCompleted, AddressOf OpenReadCallback2
                Dim uri as Uri = New Uri(address)
    client.OpenReadAsync(uri)
End Sub

Poniższy przykład kodu przedstawia implementację programu obsługi dla tego zdarzenia.

void OpenReadCallback2( Object^ /*sender*/, OpenReadCompletedEventArgs^ e )
{
   Stream^ reply = nullptr;
   StreamReader^ s = nullptr;
   try
   {
      reply = dynamic_cast<Stream^>(e->Result);
      s = gcnew StreamReader( reply );
      Console::WriteLine( s->ReadToEnd() );
   }
   finally
   {
      if ( s != nullptr )
      {
         s->Close();
      }
      if ( reply != nullptr )
      {
         reply->Close();
      }
   }

}

private static void OpenReadCallback2(Object sender, OpenReadCompletedEventArgs e)
{
    Stream reply = null;
    StreamReader s = null;

    try
    {
        reply = (Stream)e.Result;
        s = new StreamReader(reply);
        Console.WriteLine(s.ReadToEnd());
    }
    finally
    {
        if (s != null)
        {
            s.Close();
        }

        if (reply != null)
        {
            reply.Close();
        }
    }
}

Private Shared Sub OpenReadCallback2(ByVal sender As Object, ByVal e As OpenReadCompletedEventArgs)

    Dim reply As Stream = Nothing
    Dim s As StreamReader = Nothing

    Try

        reply = CType(e.Result, Stream)
        s = New StreamReader(reply)
        Console.WriteLine(s.ReadToEnd())
    Finally

        If Not s Is Nothing Then

            s.Close()
        End If

        If Not reply Is Nothing Then

            reply.Close()
        End If
    End Try
End Sub

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

To zdarzenie jest wywoływane za każdym razem, gdy operacja asynchroniczna umożliwia otwarcie strumienia zawierającego zasób. Te operacje są uruchamiane przez wywołanie metod OpenReadAsync.

OpenReadCompletedEventHandler jest pełnomocnikem tego zdarzenia. Klasa OpenReadCompletedEventArgs udostępnia program obsługi zdarzeń z danymi zdarzenia.

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.