FileRecordSequence.BeginAppend 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 penampan asinkron.
Overload
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
Memulai operasi penampan asinkron menggunakan ruang yang sebelumnya dicadangkan dalam urutan. Metode ini tidak dapat diwariskan. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
Memulai operasi penampan asinkron menggunakan ruang yang sebelumnya dicadangkan dalam urutan. Metode ini tidak dapat diwariskan. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
Memulai operasi penampan asinkron. Metode ini tidak dapat diwariskan. |
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
Memulai operasi penampan asinkron. Metode ini tidak dapat diwariskan. |
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
Memulai operasi penampan asinkron menggunakan ruang yang sebelumnya dicadangkan dalam urutan. Metode ini tidak dapat diwariskan.
public:
virtual IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginAppend (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations, AsyncCallback callback, object state);abstract member BeginAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
override this.BeginAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResultPublic Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResultParameter
- data
- IList<ArraySegment<Byte>>
Daftar segmen array byte yang akan digabungkan dan ditambahkan sebagai rekaman.
- nextUndoRecord
- SequenceNumber
Nomor urut rekaman berikutnya dalam urutan yang ditentukan pengguna.
- previousRecord
- SequenceNumber
Nomor urut rekaman berikutnya dalam Urutan sebelumnya.
- recordAppendOptions
- RecordAppendOptions
Nilai RecordAppendOptions valid yang menentukan bagaimana data harus ditulis.
- reservations
- ReservationCollection
ReservationCollection yang berisi reservasi yang harus digunakan untuk rekaman ini.
- callback
- AsyncCallback
Panggilan balik asinkron opsional, yang akan dipanggil saat penampan selesai.
- state
- Object
Objek yang disediakan pengguna yang membedakan permintaan penambahan asinkron khusus ini dari permintaan lain.
Mengembalikan
Yang IAsyncResult mewakili tambahan asinkron, yang masih bisa tertunda.
Penerapan
Pengecualian
Satu atau beberapa argumen adalah null.
Satu atau beberapa argumen berada di luar rentang.
reservations tidak dibuat oleh urutan rekaman ini.
Operasi tidak dapat dilakukan karena urutan rekaman dibuka dengan akses baca-saja.
Permintaan tidak dapat dilakukan karena pengecualian I/O yang tidak terduga.
Metode ini dipanggil setelah urutan dibuang.
Memori tidak cukup untuk melanjutkan eksekusi program.
Urutan rekaman penuh.
Tidak ada reservasi yang cukup besar agar pas data dapat ditemukan di reservations.
Keterangan
Anda harus meneruskan yang IAsyncResult dikembalikan oleh metode ini ke EndAppend metode , untuk memastikan bahwa operasi penampan telah selesai dan sumber daya dapat dibebaskan dengan tepat. Jika terjadi kesalahan selama penambalan asinkron, pengecualian tidak dilemparkan sampai EndAppend metode dipanggil dengan yang IAsyncResult dikembalikan oleh metode ini.
Data yang terkandung dalam data parameter akan digabungkan ke dalam array byte tunggal untuk ditambahkan sebagai rekaman. Namun, tidak ada ketentuan yang dibuat untuk memisahkan data kembali ke segmen array saat rekaman dibaca.
Catatan yang ditambahkan akan menggunakan ruang yang telah dipesan sebelumnya, menggunakan reservasi yang ditentukan oleh reservations parameter . Jika penambah berhasil, itu akan mengonsumsi area reservasi terkecil yang dapat menyimpan data, dan area reservasi tersebut akan dihapus dari koleksi.
Biasanya, metode ini selesai sebelum rekaman ditulis. Untuk memastikan bahwa rekaman telah ditulis, tentukan ForceFlush bendera menggunakan recordAppendOptions parameter , atau panggil Flush metode .
Berlaku untuk
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
Memulai operasi penampan asinkron menggunakan ruang yang sebelumnya dicadangkan dalam urutan. Metode ini tidak dapat diwariskan.
public:
virtual IAsyncResult ^ BeginAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginAppend (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations, AsyncCallback callback, object state);abstract member BeginAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
override this.BeginAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResultPublic Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResultParameter
- data
- ArraySegment<Byte>
Daftar segmen array byte yang akan digabungkan dan ditambahkan sebagai rekaman.
- nextUndoRecord
- SequenceNumber
Nomor urut rekaman berikutnya dalam urutan yang ditentukan pengguna.
- previousRecord
- SequenceNumber
Nomor urut rekaman berikutnya dalam Urutan sebelumnya.
- recordAppendOptions
- RecordAppendOptions
Nilai RecordAppendOptions valid yang menentukan bagaimana data harus ditulis.
- reservations
- ReservationCollection
ReservationCollection yang berisi reservasi yang harus digunakan untuk rekaman ini.
- callback
- AsyncCallback
Panggilan balik asinkron opsional, yang akan dipanggil saat penampan selesai.
- state
- Object
Objek yang disediakan pengguna yang membedakan permintaan penambahan asinkron khusus ini dari permintaan lain.
Mengembalikan
Yang IAsyncResult mewakili tambahan asinkron, yang masih bisa tertunda.
Penerapan
Pengecualian
Satu atau beberapa argumen adalah null.
Satu atau beberapa argumen berada di luar rentang.
reservations tidak dibuat oleh urutan rekaman ini.
Operasi tidak dapat dilakukan karena urutan rekaman dibuka dengan akses baca-saja.
Permintaan tidak dapat dilakukan karena pengecualian I/O yang tidak terduga.
Metode ini dipanggil setelah urutan dibuang.
Memori tidak cukup untuk melanjutkan eksekusi program.
Urutan rekaman penuh.
Tidak ada reservasi yang cukup besar agar pas data dapat ditemukan di reservations.
Keterangan
Anda harus meneruskan yang IAsyncResult dikembalikan oleh metode ini ke EndAppend metode , untuk memastikan bahwa operasi penampan telah selesai dan sumber daya dapat dibebaskan dengan tepat. Jika terjadi kesalahan selama penambalan asinkron, pengecualian tidak dilemparkan sampai EndAppend metode dipanggil dengan yang IAsyncResult dikembalikan oleh metode ini.
Data yang terkandung dalam data parameter akan digabungkan ke dalam array byte tunggal untuk ditambahkan sebagai rekaman. Namun, tidak ada ketentuan yang dibuat untuk memisahkan data kembali ke segmen array saat rekaman dibaca.
Catatan yang ditambahkan akan menggunakan ruang yang telah dipesan sebelumnya, menggunakan reservasi yang ditentukan oleh reservations parameter . Jika penambah berhasil, itu akan mengonsumsi area reservasi terkecil yang dapat menyimpan data, dan area reservasi tersebut akan dihapus dari koleksi.
Biasanya, metode ini selesai sebelum rekaman ditulis. Untuk memastikan bahwa rekaman telah ditulis, tentukan ForceFlush bendera menggunakan recordAppendOptions parameter , atau panggil Flush metode .
Berlaku untuk
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
Memulai operasi penampan asinkron. Metode ini tidak dapat diwariskan.
public:
virtual IAsyncResult ^ BeginAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginAppend (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, AsyncCallback callback, object state);abstract member BeginAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * AsyncCallback * obj -> IAsyncResult
override this.BeginAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * AsyncCallback * obj -> IAsyncResultPublic Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResultParameter
- data
- ArraySegment<Byte>
Daftar segmen array byte yang akan digabungkan dan ditambahkan sebagai rekaman.
- nextUndoRecord
- SequenceNumber
Nomor urut rekaman berikutnya dalam urutan yang ditentukan pengguna.
- previousRecord
- SequenceNumber
Nomor urut rekaman berikutnya dalam Urutan sebelumnya.
- recordAppendOptions
- RecordAppendOptions
Nilai RecordAppendOptions valid yang menentukan bagaimana data harus ditulis.
- callback
- AsyncCallback
Panggilan balik asinkron opsional, yang akan dipanggil saat penampan selesai.
- state
- Object
Objek yang disediakan pengguna yang membedakan permintaan penambahan asinkron khusus ini dari permintaan lain.
Mengembalikan
Yang IAsyncResult mewakili tambahan asinkron, yang masih bisa tertunda.
Penerapan
Pengecualian
Satu atau beberapa argumen adalah null.
Satu atau beberapa argumen berada di luar rentang.
Operasi tidak dapat dilakukan karena urutan rekaman dibuka dengan akses baca-saja.
Permintaan tidak dapat dilakukan karena pengecualian I/O yang tidak terduga.
Metode ini dipanggil setelah urutan dibuang.
Memori tidak cukup untuk melanjutkan eksekusi program.
Urutan rekaman penuh.
Keterangan
Anda harus meneruskan yang IAsyncResult dikembalikan oleh metode ini ke EndAppend metode , untuk memastikan bahwa operasi penampan telah selesai dan sumber daya dapat dibebaskan dengan tepat. Jika terjadi kesalahan selama penambalan asinkron, pengecualian tidak dilemparkan sampai EndAppend metode dipanggil dengan yang IAsyncResult dikembalikan oleh metode ini.
Data yang terkandung dalam data parameter akan digabungkan ke dalam array byte tunggal untuk ditambahkan sebagai rekaman. Namun, tidak ada ketentuan yang dibuat untuk memisahkan data kembali ke segmen array saat rekaman dibaca.
Biasanya, metode ini selesai sebelum rekaman ditulis. Untuk memastikan bahwa rekaman telah ditulis, tentukan ForceFlush bendera menggunakan recordAppendOptions parameter , atau panggil Flush metode .
Berlaku untuk
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
Memulai operasi penampan asinkron. Metode ini tidak dapat diwariskan.
public:
virtual IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginAppend (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, AsyncCallback callback, object state);abstract member BeginAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * AsyncCallback * obj -> IAsyncResult
override this.BeginAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * AsyncCallback * obj -> IAsyncResultPublic Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResultParameter
- data
- IList<ArraySegment<Byte>>
Daftar segmen array byte yang akan digabungkan dan ditambahkan sebagai rekaman.
- nextUndoRecord
- SequenceNumber
Nomor urut rekaman berikutnya dalam urutan yang ditentukan pengguna.
- previousRecord
- SequenceNumber
Nomor urut rekaman berikutnya dalam Urutan sebelumnya.
- recordAppendOptions
- RecordAppendOptions
Nilai RecordAppendOptions valid yang menentukan bagaimana data harus ditulis.
- callback
- AsyncCallback
Panggilan balik asinkron opsional, yang akan dipanggil saat penampan selesai.
- state
- Object
Objek yang disediakan pengguna yang membedakan permintaan penambahan asinkron khusus ini dari permintaan lain.
Mengembalikan
Yang IAsyncResult mewakili tambahan asinkron, yang masih bisa tertunda.
Penerapan
Pengecualian
Satu atau beberapa argumen adalah null.
Satu atau beberapa argumen berada di luar rentang.
Operasi tidak dapat dilakukan karena urutan rekaman dibuka dengan akses baca-saja.
Permintaan tidak dapat dilakukan karena pengecualian I/O yang tidak terduga.
Metode ini dipanggil setelah urutan dibuang.
Memori tidak cukup untuk melanjutkan eksekusi program.
Urutan rekaman penuh.
Keterangan
Anda harus meneruskan yang IAsyncResult dikembalikan oleh metode ini ke EndAppend metode , untuk memastikan bahwa operasi penampan telah selesai dan sumber daya dapat dibebaskan dengan tepat. Jika terjadi kesalahan selama penambalan asinkron, pengecualian tidak dilemparkan sampai EndAppend metode dipanggil dengan yang IAsyncResult dikembalikan oleh metode ini.
Data yang terkandung dalam data parameter akan digabungkan ke dalam array byte tunggal untuk ditambahkan sebagai rekaman. Namun, tidak ada ketentuan yang dibuat untuk memisahkan data kembali ke segmen array saat rekaman dibaca.
Biasanya, metode ini selesai sebelum rekaman ditulis. Untuk memastikan bahwa rekaman telah ditulis, tentukan ForceFlush bendera menggunakan recordAppendOptions parameter , atau panggil Flush metode .
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk