Bagikan melalui


IRecordSequence.BeginAppend Metode

Definisi

Ketika ditimpa di kelas turunan, memulai operasi penamangan asinkron.

Overload

BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)

Ketika ditimpa di kelas turunan, memulai operasi penautan asinkron, menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)

Ketika ditimpa di kelas turunan, memulai operasi penautan asinkron menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)

Ketika ditimpa di kelas turunan, memulai operasi penamangan asinkron.

BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)

Ketika ditimpa di kelas turunan, memulai operasi penautan asinkron, menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)

Ketika ditimpa di kelas turunan, memulai operasi penautan asinkron, menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

public:
 IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousUndoRecord, 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 previousUndoRecord, 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
Public Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousUndoRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

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.

previousUndoRecord
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 catatan ini.

callback
AsyncCallback

Panggilan balik asinkron opsional, yang akan dipanggil saat penambah 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.

Pengecualian

Satu atau beberapa argumen tidak valid.

Terjadi kesalahan I/O saat menambahkan rekaman.

Urutan rekaman tidak dapat membuat ruang kosong yang cukup untuk memuat rekaman baru.

Metode ini dipanggil setelah urutan dibuang.

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 sebelumnya telah dipesan, 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 pengumpulan.

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)

Ketika ditimpa di kelas turunan, memulai operasi penautan asinkron menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

public:
 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
Public 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 IAsyncResult

Parameter

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 catatan ini.

callback
AsyncCallback

Panggilan balik asinkron opsional, yang akan dipanggil saat penambah 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.

Pengecualian

Satu atau beberapa argumen tidak valid.

Terjadi kesalahan I/O saat menambahkan rekaman.

Urutan rekaman tidak dapat membuat ruang kosong yang cukup untuk memuat rekaman baru.

Metode ini dipanggil setelah urutan dibuang.

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 sebelumnya telah dipesan, 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 pengumpulan.

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)

Ketika ditimpa di kelas turunan, memulai operasi penamangan asinkron.

public:
 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
Public Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

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 penambah 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.

Pengecualian

Satu atau beberapa argumen tidak valid.

Terjadi kesalahan I/O saat menambahkan rekaman.

Urutan rekaman tidak dapat membuat ruang kosong yang cukup untuk memuat rekaman baru.

Metode ini dipanggil setelah urutan dibuang.

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)

Ketika ditimpa di kelas turunan, memulai operasi penautan asinkron, menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

public:
 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
Public 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 IAsyncResult

Parameter

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 penambah 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.

Pengecualian

Satu atau beberapa argumen tidak valid.

Terjadi kesalahan I/O saat menambahkan rekaman.

Urutan rekaman tidak dapat membuat ruang kosong yang cukup untuk memuat rekaman baru.

Metode ini dipanggil setelah urutan dibuang.

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