BufferedStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Memulai operasi tulis asinkron. (Pertimbangkan untuk menggunakan WriteAsync(Byte[], Int32, Int32, CancellationToken) sebagai gantinya.)
public:
override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object? state);
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult
Parameter
- buffer
- Byte[]
Buffer yang berisi data untuk ditulis ke aliran saat ini.
- offset
- Int32
Offset byte berbasis nol untuk buffer
mulai menyalin byte ke aliran saat ini.
- count
- Int32
Jumlah maksimum byte yang akan ditulis.
- callback
- AsyncCallback
Metode yang akan dipanggil ketika operasi penulisan asinkron selesai.
- state
- Object
Objek yang disediakan pengguna yang membedakan permintaan tulis asinkron khusus ini dari permintaan lain.
Mengembalikan
Objek yang mereferensikan penulisan asinkron yang masih bisa tertunda.
Pengecualian
buffer
panjang minus offset
kurang dari count
.
buffer
adalah null
.
offset
atau count
negatif.
Aliran tidak mendukung penulisan.
Keterangan
Dalam .NET Framework 4 dan versi yang lebih lama, Anda harus menggunakan metode seperti BeginWrite dan EndWrite untuk menerapkan operasi file asinkron. Metode ini masih tersedia di .NET Framework 4.5 untuk mendukung kode warisan; namun, metode asinkron baru, seperti ReadAsync, WriteAsync, dan FlushAsync, membantu Anda menerapkan operasi file asinkron dengan lebih mudah.
EndWrite harus dipanggil tepat sekali pada setiap IAsyncResult dari BeginWrite. EndWrite akan memblokir hingga operasi I/O selesai.