LogRecordSequence.BeginAppend Metode

Definisi

Ruang nama:

System.IO.Log

Rakitan:

System.IO.Log.dll

Memulai operasi penamangan asinkron.

Overload

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(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, 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. Metode ini tidak dapat diwariskan.

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 -> 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 penampan selesai.

state

Object

Objek yang disediakan pengguna yang membedakan permintaan penambahan asinkron khusus ini dari permintaan lain.

Mengembalikan

IAsyncResult

Yang IAsyncResult mewakili tambahan asinkron, yang masih bisa tertunda.

Penerapan

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

Pengecualian

ArgumentException

nextUndoRecord atau previousRecord tidak valid untuk urutan ini.

-atau-

data tidak dapat ditambahkan karena lebih besar dari ukuran rekaman maksimum.

-atau-

reservations tidak dibuat oleh urutan rekaman ini.

ArgumentNullException

Satu atau beberapa argumen adalah null.

ArgumentOutOfRangeException

nextUndoRecord atau previousRecord bukan antara nomor urutan dasar dan terakhir dari urutan ini.

IOException

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

-atau-

Permintaan tidak dapat dilakukan karena kesalahan perangkat I/O.

NotSupportedException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

OutOfMemoryException

Memori tidak cukup untuk melanjutkan eksekusi program.

SequenceFullException

Urutan rekaman penuh.

UnauthorizedAccessException

Akses untuk urutan log yang ditentukan ditolak oleh sistem operasi.

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 .

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 userRecord, 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 userRecord, 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 -> IAsyncResult

Public Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), userRecord 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.

userRecord

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

IAsyncResult

Yang IAsyncResult mewakili tambahan asinkron, yang masih bisa tertunda.

Penerapan

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

Pengecualian

ArgumentException

userRecord atau previousRecord tidak valid untuk urutan ini.

-atau-

data tidak dapat ditambahkan karena lebih besar dari ukuran rekaman maksimum.

-atau-

reservations tidak dibuat oleh urutan rekaman ini.

ArgumentNullException

Satu atau beberapa argumen adalah null.

ArgumentOutOfRangeException

userRecord atau previousRecord bukan antara nomor urutan dasar dan terakhir dari urutan ini.

IOException

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

-atau-

Permintaan tidak dapat dilakukan karena kesalahan perangkat I/O.

NotSupportedException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

OutOfMemoryException

Memori tidak cukup untuk melanjutkan eksekusi program.

SequenceFullException

Urutan rekaman penuh.

UnauthorizedAccessException

Akses untuk urutan log yang ditentukan ditolak oleh sistem operasi.

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 .

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

Memulai operasi penamangan 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, 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 -> 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 rekaman 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

IAsyncResult

Yang IAsyncResult mewakili tambahan asinkron, yang masih bisa tertunda.

Penerapan

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

Pengecualian

ArgumentException

userRecord atau previousRecord tidak valid untuk urutan ini.

-atau-

data tidak dapat ditambahkan karena lebih besar dari ukuran rekaman maksimum.

-atau-

reservations tidak dibuat oleh urutan rekaman ini.

ArgumentNullException

Satu atau beberapa argumen adalah null.

ArgumentOutOfRangeException

userRecord atau previousRecord bukan antara nomor urutan dasar dan terakhir dari urutan ini.

IOException

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

-atau-

Permintaan tidak dapat dilakukan karena kesalahan perangkat I/O.

NotSupportedException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

OutOfMemoryException

Memori tidak cukup untuk melanjutkan eksekusi program.

SequenceFullException

Urutan rekaman penuh.

UnauthorizedAccessException

Akses untuk urutan log yang ditentukan ditolak oleh sistem operasi.

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

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

Memulai operasi penamangan asinkron. Metode ini tidak dapat diwariskan.

public:
 virtual IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber userRecord, 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 userRecord, 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 -> IAsyncResult

Public Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), userRecord As SequenceNumber, previousRecord 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.

userRecord

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

IAsyncResult

Yang IAsyncResult mewakili tambahan asinkron, yang masih bisa tertunda.

Penerapan

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

Pengecualian

ArgumentException

userRecord atau previousRecord tidak valid untuk urutan ini.

-atau-

data tidak dapat ditambahkan karena lebih besar dari ukuran rekaman maksimum.

-atau-

reservations tidak dibuat oleh urutan rekaman ini.

ArgumentNullException

Satu atau beberapa argumen adalah null.

ArgumentOutOfRangeException

userRecord atau previousRecord bukan antara nomor urutan dasar dan urutan terakhir dari urutan ini.

IOException

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

-atau-

Permintaan tidak dapat dilakukan karena kesalahan perangkat I/O.

NotSupportedException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

OutOfMemoryException

Memori tidak cukup untuk melanjutkan eksekusi program.

SequenceFullException

Urutan rekaman penuh.

UnauthorizedAccessException

Akses untuk urutan log yang ditentukan ditolak oleh sistem operasi.

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