Bagikan melalui

FileRecordSequence.BeginReserveAndAppend Metode

  • Referensi

Definisi

Ruang nama:
System.IO.Log
Rakitan:
System.IO.Log.dll

Memulai operasi pencadangan dan penamangan asinkron.

Overload

BeginReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Memulai operasi pencadangan dan penamangan asinkron. Metode ini tidak dapat diwariskan.
BeginReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Memulai operasi pencadangan dan penamangan asinkron. Metode ini tidak dapat diwariskan.

BeginReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Memulai operasi pencadangan dan penamangan asinkron. Metode ini tidak dapat diwariskan.

public:
 virtual IAsyncResult ^ BeginReserveAndAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservationCollection, cli::array <long> ^ reservations, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginReserveAndAppend (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservationCollection, long[] reservations, AsyncCallback callback, object state);
abstract member BeginReserveAndAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] * AsyncCallback * obj -> IAsyncResult
override this.BeginReserveAndAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] * AsyncCallback * obj -> IAsyncResult
Public Function BeginReserveAndAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, reservations As Long(), 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.

reservationCollection
ReservationCollection

Pengumpulan reservasi untuk melakukan reservasi.

reservations
Int64[]

Reservasi yang harus dibuat, dalam byte.

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

IAsyncResult

Yang IAsyncResult mewakili operasi asinkron ini, yang masih bisa tertunda.

Penerapan

BeginReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Pengecualian

ArgumentNullException

Satu atau beberapa argumen adalah null.

ArgumentOutOfRangeException

Satu atau beberapa argumen berada di luar rentang.

ArgumentException

reservations tidak dibuat oleh urutan rekaman ini.

NotSupportedException

Operasi tidak dapat dilakukan karena urutan rekaman dibuka dengan akses baca-saja.

IOException

Permintaan tidak dapat dilakukan karena pengecualian I/O yang tidak terduga.

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

OutOfMemoryException

Memori tidak cukup untuk melanjutkan eksekusi program.

SequenceFullException

Urutan rekaman penuh.

ReservationNotFoundException

Tidak ada reservasi yang cukup besar agar pas data dapat ditemukan di reservations.

Keterangan

Anda harus meneruskan yang IAsyncResult dikembalikan oleh metode ini ke EndReserveAndAppend 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 EndReserveAndAppend 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.

Reservasi yang ditentukan ditambahkan ke koleksi reservasi yang disediakan dalam operasi atomik dengan operasi penambahan rekaman. Jika penampan gagal, tidak ada ruang yang dicadangkan.

Biasanya, metode ini dapat diselesaikan sebelum rekaman ditulis. Untuk memastikan bahwa rekaman telah ditulis, tentukan ForceFlush bendera menggunakan recordAppendOptions parameter , atau panggil Flush metode .

Jika urutan rekaman telah dibuang, atau jika Anda meneruskan argumen yang tidak valid, pengecualian segera dilemparkan dalam operasi ini. Kesalahan yang terjadi selama permintaan penautan asinkron, misalnya, kegagalan disk selama permintaan I/O, akan mengakibatkan pengecualian dilemparkan ketika EndReserveAndAppend metode dipanggil.

Berlaku untuk

BeginReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Memulai operasi pencadangan dan penamangan asinkron. Metode ini tidak dapat diwariskan.

public:
 virtual IAsyncResult ^ BeginReserveAndAppend(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 ^ reservationCollection, cli::array <long> ^ reservations, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginReserveAndAppend (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 reservationCollection, long[] reservations, AsyncCallback callback, object state);
abstract member BeginReserveAndAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] * AsyncCallback * obj -> IAsyncResult
override this.BeginReserveAndAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] * AsyncCallback * obj -> IAsyncResult
Public Function BeginReserveAndAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, reservations As Long(), 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.

reservationCollection
ReservationCollection

Pengumpulan reservasi untuk melakukan reservasi.

reservations
Int64[]

Reservasi yang harus dibuat, dalam byte.

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

IAsyncResult

Yang IAsyncResult mewakili operasi asinkron ini, yang masih bisa tertunda.

Penerapan

BeginReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)

Pengecualian

ArgumentNullException

Satu atau beberapa argumen adalah null.

ArgumentOutOfRangeException

Satu atau beberapa argumen berada di luar rentang.

ArgumentException

reservations tidak dibuat oleh urutan rekaman ini.

NotSupportedException

Operasi tidak dapat dilakukan karena urutan rekaman dibuka dengan akses baca-saja.

IOException

Permintaan tidak dapat dilakukan karena pengecualian I/O yang tidak terduga.

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

OutOfMemoryException

Memori tidak cukup untuk melanjutkan eksekusi program.

SequenceFullException

Urutan rekaman penuh.

ReservationNotFoundException

Tidak ada reservasi yang cukup besar agar pas data dapat ditemukan di reservations.

Keterangan

Anda harus meneruskan yang IAsyncResult dikembalikan oleh metode ini ke EndReserveAndAppend 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 EndReserveAndAppend 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.

Reservasi yang ditentukan ditambahkan ke koleksi reservasi yang disediakan dalam operasi atomik dengan operasi penambahan rekaman. Jika penampan gagal, tidak ada ruang yang dicadangkan.

Biasanya, metode ini dapat diselesaikan sebelum rekaman ditulis. Untuk memastikan bahwa rekaman telah ditulis, tentukan ForceFlush bendera menggunakan recordAppendOptions parameter , atau panggil Flush metode .

Jika urutan rekaman telah dibuang, atau jika Anda meneruskan argumen yang tidak valid, pengecualian segera dilemparkan dalam operasi ini. Kesalahan yang terjadi selama permintaan penautan asinkron, misalnya, kegagalan disk selama permintaan I/O, akan mengakibatkan pengecualian dilemparkan ketika EndReserveAndAppend metode dipanggil.

Berlaku untuk