OpenReadCompletedEventArgs Klasse

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Quelle:

WebClient.cs

Stellt Daten für das OpenReadCompleted-Ereignis bereit.

public ref class OpenReadCompletedEventArgs : System::ComponentModel::AsyncCompletedEventArgs

public class OpenReadCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs

type OpenReadCompletedEventArgs = class
    inherit AsyncCompletedEventArgs

Public Class OpenReadCompletedEventArgs
Inherits AsyncCompletedEventArgs

Vererbung

Object

EventArgs

AsyncCompletedEventArgs

OpenReadCompletedEventArgs

Beispiele

Im folgenden Codebeispiel wird das Herunterladen einer Ressource zum Lesen veranschaulicht.

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

Die folgende Methode wird aufgerufen, wenn der Download abgeschlossen ist.

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

Hinweise

Instanzen dieser Klasse werden an OpenReadCompletedEventHandler Methoden übergeben.

Eigenschaften

Cancelled	Ruft einen Wert ab, der angibt, ob ein asynchroner Vorgang abgebrochen wurde. (Geerbt von AsyncCompletedEventArgs)
Error	Ruft einen Wert ab, der angibt, welcher Fehler während eines asynchronen Vorgangs aufgetreten ist. (Geerbt von AsyncCompletedEventArgs)
Result	Ruft einen lesbaren Stream ab, der von einer DownloadDataAsync-Methode heruntergeladene Daten enthält.
UserState	Ruft den eindeutigen Bezeichner der asynchronen Aufgabe ab. (Geerbt von AsyncCompletedEventArgs)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RaiseExceptionIfNecessary()	Löst eine benutzerdefinierte Ausnahme aus, wenn bei einem asynchronen Vorgang ein Fehler aufgetreten ist. (Geerbt von AsyncCompletedEventArgs)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)