PipeStream.EndRead(IAsyncResult) Methode

Definition

Beendet eine ausstehende asynchrone Leseanforderung.Ends a pending asynchronous read request.

public:
 override int EndRead(IAsyncResult ^ asyncResult);
public override int EndRead (IAsyncResult asyncResult);
[System.Security.SecurityCritical]
public override int EndRead (IAsyncResult asyncResult);
override this.EndRead : IAsyncResult -> int
Public Overrides Function EndRead (asyncResult As IAsyncResult) As Integer

Parameter

asyncResult
IAsyncResult

Der Verweis auf die ausstehende asynchrone Anforderung.The reference to the pending asynchronous request.

Gibt zurück

Int32

Die Anzahl von Bytes, die gelesen wurden.The number of bytes that were read. Der Rückgabewert 0 (null) gibt das Ende des Streams an (d. h., die Pipe wurde geschlossen).A return value of 0 indicates the end of the stream (the pipe has been closed).

Attribute

Ausnahmen

asyncResult ist nullasyncResult is null.

asyncResult basiert nicht auf einer BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)-Methode im aktuellen Stream.asyncResult did not originate from a BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) method on the current stream.

Der Stream ist geschlossen, oder ein interner Fehler ist aufgetreten.The stream is closed or an internal error has occurred.

Hinweise

Diese Methode gibt die Anzahl der Bytes zurück, die in das Bytearray gelesen werden, das durch den früheren BeginReadaufgerufen wurde.This method returns the number of bytes read into the byte array specified by the earlier call to BeginRead.

Übergeben Sie das zurückgegebene IAsyncResult Objekt an die EndRead-Methode, um zu bestimmen, wie viele Bytes gelesen wurden, und um die zum Lesen verwendeten Betriebssystemressourcen freizugeben.Pass the returned IAsyncResult object to the EndRead method to determine how many bytes were read and to release operating system resources used for reading. EndRead müssen für jeden Aufruf von BeginReadeinmal aufgerufen werden.EndRead must be called once for every call to BeginRead. Dies kann entweder im gleichen Code erfolgen, der BeginRead aufgerufen hat, oder in einem Rückruf, der an BeginReadübermittelt wird.This can be done either in the same code that called BeginRead or in a callback that is passed to BeginRead.

Verwenden Sie die CanRead-Eigenschaft, um zu bestimmen, ob das aktuelle PipeStream-Objekt Lesevorgänge unterstützt.Use the CanRead property to determine whether the current PipeStream object supports read operations.

Wenn die Pipe geschlossen ist oder ein ungültiges Argument an BeginReadübergeben wird, werden sofort die entsprechenden Ausnahmen ausgelöst.If the pipe is closed or an invalid argument is passed to BeginRead, the appropriate exceptions are raised immediately. Fehler, die bei einer asynchronen Lese Anforderung auftreten, treten in dem Thread Pool Thread auf, der die Anforderung ausführt.Errors that occur during an asynchronous read request occur on the thread pool thread that is performing the request. Die Ausnahmen werden ausgelöst, wenn der Code die EndRead-Methode aufruft.The exceptions are raised when the code calls the EndRead method.

Gilt für: