Stream.EndWrite(IAsyncResult) Methode

Definition

Beendet einen asynchronen Schreibvorgang.Ends an asynchronous write operation. (Verwenden Sie stattdessen WriteAsync(Byte[], Int32, Int32).)(Consider using WriteAsync(Byte[], Int32, Int32) instead.)

public:
 virtual void EndWrite(IAsyncResult ^ asyncResult);
public virtual void EndWrite (IAsyncResult asyncResult);
abstract member EndWrite : IAsyncResult -> unit
override this.EndWrite : IAsyncResult -> unit
Public Overridable Sub EndWrite (asyncResult As IAsyncResult)

Parameter

asyncResult
IAsyncResult

Ein Verweis auf die ausstehende asynchrone E/A-Anforderung.A reference to the outstanding asynchronous I/O request.

Ausnahmen

asyncResult ist null.asyncResult is null.

Ein Handle für den ausstehenden Schreibvorgang ist nicht verfügbar.A handle to the pending write operation is not available.

- oder --or-

Die anstehende Operation unterstützt keine Schreibvorgänge.The pending operation does not support writing.

asyncResult basiert nicht auf einer BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)-Methode im aktuellen Stream.asyncResult did not originate from a BeginWrite(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

In .NET Framework 4 und vorherigen Versionen müssen Sie Methoden wie BeginWrite und EndWrite verwenden, um asynchrone E/A-Vorgänge zu implementieren.In the .NET Framework 4 and earlier versions, you have to use methods such as BeginWrite and EndWrite to implement asynchronous I/O operations. Diese Methoden sind .NET Framework 4.5.NET Framework 4.5 weiterhin in verfügbar, um Legacy Code zu unterstützen. die neuen Async-Methoden, ReadAsyncwie z WriteAsync. b. FlushAsync,, CopyToAsyncund, unterstützen Sie jedoch bei der einfacheren Implementierung asynchroner e/a-Vorgänge.These methods are still available in the .NET Framework 4.5.NET Framework 4.5 to support legacy code; however, the new async methods, such as ReadAsync, WriteAsync, CopyToAsync, and FlushAsync, help you implement asynchronous I/O operations more easily.

EndWritemuss bei jedem IAsyncResult von BeginWritegenau einmal aufgerufen werden.EndWrite must be called exactly once on every IAsyncResult from BeginWrite.

Diese Methode blockiert, bis die E/A-Operation abgeschlossen ist.This method blocks until the I/O operation has completed. Fehler, die während einer asynchronen Schreib Anforderung auftreten, z. b. ein Datenträger Fehler während der e/a-Anforderung, treten im Thread Pool Thread auf und werden EndWritebei einem-Rückruf sichtbar.Errors that occur during an asynchronous write request, such as a disk failure during the I/O request, occur on the thread pool thread and become visible upon a call to EndWrite. Ausnahmen, die vom Thread Pool Thread ausgelöst werden, sind beim Aufrufen EndWritevon nicht sichtbar.Exceptions thrown by the thread pool thread will not be visible when calling EndWrite.

Gilt für:

Siehe auch