Stream.EndRead-Methode

Artikel
08/20/2007

Wartet, bis der ausstehende asynchrone Lesevorgang abgeschlossen ist.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overridable Function EndRead ( _
    asyncResult As IAsyncResult _
) As Integer
'Usage
Dim instance As Stream
Dim asyncResult As IAsyncResult
Dim returnValue As Integer

returnValue = instance.EndRead(asyncResult)

public virtual int EndRead (
    IAsyncResult asyncResult
)

public:
virtual int EndRead (
    IAsyncResult^ asyncResult
)

public int EndRead (
    IAsyncResult asyncResult
)

public function EndRead (
    asyncResult : IAsyncResult
) : int

Parameter

asyncResult
Der Verweis auf die ausstehende asynchrone Anforderung, die beendet werden soll.

Rückgabewert

Die Anzahl der aus dem Stream gelesenen Bytes. Diese Anzahl kann zwischen 0 und der Anzahl der angeforderten Bytes liegen. Streams geben nur am Ende des Streams 0 zurück, andernfalls sollten sie blockieren, bis mindestens 1 Byte verfügbar ist.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	asyncResult ist NULL (Nothing in Visual Basic).
ArgumentException	asyncResult stammt nicht von einer BeginRead-Methode im aktuellen Stream.

Hinweise

Ein Beispiel für das Erstellen einer Datei und das Schreiben von Text in eine Datei finden Sie unter Gewusst wie: Schreiben von Text in eine Datei. Ein Beispiel für das Lesen von Text aus einer Datei finden Sie unter Gewusst wie: Lesen aus einer Textdatei. Ein Beispiel für das Lesen aus einer Binärdatei und das Schreiben in eine Binärdatei finden Sie unter Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei. Ein Beispiel für asynchrones Datei-E/A finden Sie unter Asynchrone Datei-E/A.

Rufen Sie EndRead auf, um zu bestimmen, wie viele Bytes aus dem Stream gelesen wurden.

EndRead kann für jedes IAsyncResult von BeginRead einmal aufgerufen werden.

Diese Methode blockiert, bis der E/A-Vorgang abgeschlossen ist.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Stream-Klasse
Stream-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei
Asynchrone Datei-E/A

Freigeben über