IRecordSequence.BeginWriteRestartArea Metode

Definisi

Ruang nama:

System.IO.Log

Rakitan:

System.IO.Log.dll

Ketika ditimpa di kelas turunan, memulai operasi penulisan area hidupkan ulang asinkron.

Overload

BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)	Ketika ditimpa di kelas turunan, memulai operasi penulisan area hidupkan ulang asinkron, menggunakan ruang yang sebelumnya dicadangkan dalam urutan.
BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)	Ketika ditimpa di kelas turunan, memulai operasi penulisan area hidupkan ulang asinkron, menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Ketika ditimpa di kelas turunan, memulai operasi penulisan area hidupkan ulang asinkron, menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

public:
 IAsyncResult ^ BeginWriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginWriteRestartArea (ArraySegment<byte> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, System.IO.Log.ReservationCollection reservation, AsyncCallback callback, object state);

abstract member BeginWriteRestartArea : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult

Public Function BeginWriteRestartArea (data As ArraySegment(Of Byte), newBaseSequenceNumber As SequenceNumber, reservation 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.

newBaseSequenceNumber

SequenceNumber

Nomor urutan dasar baru. Angka urutan yang ditentukan harus lebih besar dari atau sama dengan nomor urutan dasar saat ini.

reservation

ReservationCollection

ReservationCollection yang berisi reservasi yang harus digunakan untuk area hidupkan ulang ini.

callback

AsyncCallback

Panggilan balik asinkron opsional, yang akan dipanggil ketika penulisan area hidupkan ulang selesai.

state

Object

Objek yang disediakan pengguna yang membedakan permintaan tulis area hidupkan ulang asinkron khusus ini dari permintaan lain.

Mengembalikan

IAsyncResult

Yang IAsyncResult mewakili operasi penulisan area hidupkan ulang asinkron, yang masih bisa tertunda.

Keterangan

Anda harus meneruskan yang IAsyncResult dikembalikan oleh metode ini ke EndWriteRestartArea metode , untuk memastikan bahwa operasi penulisan area hidupkan ulang telah selesai dan sumber daya dapat dibebaskan dengan tepat. Jika terjadi kesalahan selama operasi penulisan area hidupkan ulang asinkron, pengecualian tidak dilemparkan sampai EndWriteRestartArea 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.

Ketika operasi berhasil diselesaikan, nomor urutan dasar telah diperbarui. Semua rekaman log dengan nomor urut kurang dari nomor urutan dasar baru tidak dapat diakses.

ReservationCollection Jika ditentukan, area hidupkan ulang tertulis akan menggunakan ruang yang telah dipesan sebelumnya, menggunakan reservasi yang terkandung dalam koleksi. Jika metode berhasil, metode akan menggunakan reservasi terkecil yang dapat menyimpan data, dan reservasi tersebut akan dihapus dari koleksi.

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 EndWriteRestartArea metode dipanggil.

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

Ketika ditimpa di kelas turunan, memulai operasi penulisan area hidupkan ulang asinkron, menggunakan ruang yang sebelumnya dicadangkan dalam urutan.

public:
 IAsyncResult ^ BeginWriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginWriteRestartArea (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, System.IO.Log.ReservationCollection reservation, AsyncCallback callback, object state);

abstract member BeginWriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult

Public Function BeginWriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSequenceNumber As SequenceNumber, reservation 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.

newBaseSequenceNumber

SequenceNumber

Nomor urutan dasar baru. Angka urutan yang ditentukan harus lebih besar dari atau sama dengan nomor urutan dasar saat ini.

reservation

ReservationCollection

ReservationCollection yang berisi reservasi yang harus digunakan untuk area hidupkan ulang ini.

callback

AsyncCallback

Panggilan balik asinkron opsional, yang akan dipanggil ketika penulisan area hidupkan ulang selesai.

state

Object

Objek yang disediakan pengguna yang membedakan permintaan tulis area hidupkan ulang asinkron khusus ini dari permintaan lain.

Mengembalikan

IAsyncResult

Yang IAsyncResult mewakili operasi penulisan area hidupkan ulang asinkron, yang masih bisa tertunda.

Pengecualian

ArgumentException

Satu atau beberapa argumen tidak valid.

IOException

Terjadi kesalahan I/O saat menulis area hidupkan ulang.

SequenceFullException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

Keterangan

Anda harus meneruskan yang IAsyncResult dikembalikan oleh metode ini ke EndWriteRestartArea metode untuk memastikan bahwa operasi penulisan area hidupkan ulang telah selesai dan sumber daya dapat dibebaskan dengan tepat. Jika terjadi kesalahan selama operasi penulisan area hidupkan ulang asinkron, pengecualian tidak dilemparkan sampai EndWriteRestartArea 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.

Ketika operasi berhasil diselesaikan, nomor urutan dasar telah diperbarui. Semua rekaman log dengan nomor urut kurang dari nomor urutan dasar baru tidak dapat diakses.

ReservationCollection Jika ditentukan, area hidupkan ulang tertulis akan menggunakan ruang yang telah dipesan sebelumnya, menggunakan reservasi yang terkandung dalam koleksi. Jika metode berhasil, metode akan menggunakan reservasi terkecil yang dapat menyimpan data, dan reservasi tersebut akan dihapus dari koleksi.

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 EndWriteRestartArea metode dipanggil.