BufferedStream::BeginWrite Method (array<Byte>^, Int32, Int32, AsyncCallback^, Object^)
Begins an asynchronous write operation. (Consider using WriteAsync instead; see the Remarks section.)
Assembly: mscorlib (in mscorlib.dll)
public: virtual IAsyncResult^ BeginWrite( array<unsigned char>^ buffer, int offset, int count, AsyncCallback^ callback, Object^ state ) override
Parameters
- buffer
-
Type:
array<System::Byte>^
The buffer containing data to write to the current stream.
- offset
-
Type:
System::Int32
The zero-based byte offset in buffer at which to begin copying bytes to the current stream.
- count
-
Type:
System::Int32
The maximum number of bytes to write.
- callback
-
Type:
System::AsyncCallback^
The method to be called when the asynchronous write operation is completed.
- state
-
Type:
System::Object^
A user-provided object that distinguishes this particular asynchronous write request from other requests.
Return Value
Type: System::IAsyncResult^An object that references the asynchronous write which could still be pending.
| Exception | Condition |
|---|---|
| ArgumentException | buffer length minus offset is less than count. |
| ArgumentNullException | buffer is null. |
| ArgumentOutOfRangeException | offset or count is negative. |
| NotSupportedException | The stream does not support writing. |
In the .NET Framework 4 and earlier versions, you have to use methods such as BeginWrite and EndWrite to implement asynchronous file operations. These methods are still available in the .NET Framework 4.5 to support legacy code; however, the new async methods, such as ReadAsync, WriteAsync, and FlushAsync, help you implement asynchronous file operations more easily.
EndWrite must be called exactly once on every IAsyncResult from BeginWrite. EndWrite will block until the I/O operation has completed.
Available since 4.5