IRecordSequence.Append Metode

Definisi

Ruang nama:

System.IO.Log

Rakitan:

System.IO.Log.dll

Ketika ditimpa di kelas turunan, tulis catatan log ke IRecordSequence.

Overload

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Ketika ditimpa di kelas turunan, tulis catatan log ke IRecordSequence.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Saat ditimpa di kelas turunan, tambahkan catatan log ke IRecordSequence.
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	Ketika ditimpa di kelas turunan, menambahkan catatan log ke IRecordSequence, menggunakan ruang yang sebelumnya dipesan dalam urutan.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	Ketika ditimpa di kelas turunan, menambahkan catatan log ke IRecordSequence, menggunakan ruang yang sebelumnya dipesan dalam urutan.

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)

Ketika ditimpa di kelas turunan, tulis catatan log ke IRecordSequence.

public:
 System::IO::Log::SequenceNumber Append(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions);

public System.IO.Log.SequenceNumber Append (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions);

abstract member Append : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions -> System.IO.Log.SequenceNumber

Public Function Append (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumber

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.

Mengembalikan

SequenceNumber

Nomor urut rekaman log yang ditambahkan.

Pengecualian

ArgumentException

Satu atau beberapa argumen tidak valid.

IOException

Terjadi kesalahan I/O saat menambahkan rekaman.

SequenceFullException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

Keterangan

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 .

Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)

Saat ditimpa di kelas turunan, tambahkan catatan log ke IRecordSequence.

public:
 System::IO::Log::SequenceNumber Append(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions);

public System.IO.Log.SequenceNumber Append (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions);

abstract member Append : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions -> System.IO.Log.SequenceNumber

Public Function Append (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumber

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.

Mengembalikan

SequenceNumber

Nomor urut rekaman log yang ditambahkan.

Pengecualian

ArgumentException

Satu atau beberapa argumen tidak valid.

IOException

Terjadi kesalahan I/O saat menambahkan rekaman.

SequenceFullException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

Keterangan

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 .

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)

Ketika ditimpa di kelas turunan, menambahkan catatan log ke IRecordSequence, menggunakan ruang yang sebelumnya dipesan dalam urutan.

public:
 System::IO::Log::SequenceNumber Append(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations);

public System.IO.Log.SequenceNumber Append (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations);

abstract member Append : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber

Public Function Append (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumber

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.

Mengembalikan

SequenceNumber

Nomor urut rekaman log yang ditambahkan.

Pengecualian

ArgumentException

Satu atau beberapa argumen tidak valid.

IOException

Terjadi kesalahan I/O saat menambahkan rekaman.

SequenceFullException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

Keterangan

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 .

Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)

Ketika ditimpa di kelas turunan, menambahkan catatan log ke IRecordSequence, menggunakan ruang yang sebelumnya dipesan dalam urutan.

public:
 System::IO::Log::SequenceNumber Append(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);

public System.IO.Log.SequenceNumber Append (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);

abstract member Append : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber

Public Function Append (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumber

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.

reservations

ReservationCollection

ReservationCollection yang berisi reservasi yang harus digunakan untuk rekaman ini.

Mengembalikan

SequenceNumber

Nomor urut rekaman log yang ditambahkan.

Pengecualian

ArgumentException

Satu atau beberapa argumen tidak valid.

IOException

Terjadi kesalahan I/O saat menambahkan rekaman.

SequenceFullException

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

ObjectDisposedException

Metode ini dipanggil setelah urutan dibuang.

Keterangan

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 .