IRecordSequence.Append 方法

定義

命名空間:

System.IO.Log

組件:

System.IO.Log.dll

在衍生類別中覆寫時，將記錄檔記錄寫入 IRecordSequence。

多載

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)	在衍生類別中覆寫時，將記錄檔記錄寫入 IRecordSequence。
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)	在衍生類別中覆寫時，將記錄檔記錄附加到 IRecordSequence。
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	在衍生類別中覆寫時，使用之前在順序中保留的空間，將記錄檔記錄附加到 IRecordSequence。
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	在衍生類別中覆寫時，使用之前在順序中保留的空間，將記錄檔記錄附加到 IRecordSequence。

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

在衍生類別中覆寫時，將記錄檔記錄寫入 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

參數

data

ArraySegment<Byte>

即將串連並附加成記錄之位元組陣列區段的清單。

nextUndoRecord

SequenceNumber

下一筆記錄的序號 (依照使用者指定的順序)。

previousRecord

SequenceNumber

下一筆記錄的序號 (依照之前的順序)。

recordAppendOptions

RecordAppendOptions

RecordAppendOptions 的有效值，其中指定資料的寫入方式。

傳回

SequenceNumber

已附加之記錄的序號。

例外狀況

ArgumentException

一或多個引數無效。

IOException

附加記錄時發生 I/O 錯誤。

SequenceFullException

記錄順序無法騰出足夠的可用空間來容納新的記錄。

ObjectDisposedException

已在處置序列之後呼叫此方法。

備註

包含在 data 參數中的資料將串連至單一位元組陣列中，以便附加成記錄。 不過，在讀取記錄時，並不會將資料分割回陣列區段。

此方法通常會在寫入記錄前完成。 若要確定已寫入某筆記錄，請使用 ForceFlush 參數指定 recordAppendOptions 旗標，或是呼叫 Flush 方法。

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

在衍生類別中覆寫時，將記錄檔記錄附加到 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

參數

data

IList<ArraySegment<Byte>>

即將串連並附加成記錄之位元組陣列區段的清單。

nextUndoRecord

SequenceNumber

下一筆記錄的序號 (依照使用者指定的順序)。

previousRecord

SequenceNumber

下一筆記錄的序號 (依照之前的順序)。

recordAppendOptions

RecordAppendOptions

RecordAppendOptions 的有效值，其中指定資料的寫入方式。

傳回

SequenceNumber

已附加之記錄的序號。

例外狀況

ArgumentException

一或多個引數無效。

IOException

附加記錄時發生 I/O 錯誤。

SequenceFullException

記錄順序無法騰出足夠的可用空間來容納新的記錄。

ObjectDisposedException

已在處置序列之後呼叫此方法。

備註

包含在 data 參數中的資料將串連至單一位元組陣列中，以便附加成記錄。 不過，在讀取記錄時，並不會將資料分割回陣列區段。

此方法通常會在寫入記錄前完成。 若要確定已寫入某筆記錄，請使用 ForceFlush 參數指定 recordAppendOptions 旗標，或是呼叫 Flush 方法。

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

在衍生類別中覆寫時，使用之前在順序中保留的空間，將記錄檔記錄附加到 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, 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

參數

data

ArraySegment<Byte>

即將串連並附加成記錄之位元組陣列區段的清單。

nextUndoRecord

SequenceNumber

下一筆記錄的序號 (依照使用者指定的順序)。

previousRecord

SequenceNumber

下一筆記錄的序號 (依照之前的順序)。

recordAppendOptions

RecordAppendOptions

RecordAppendOptions 的有效值，其中指定資料的寫入方式。

reservations

ReservationCollection

ReservationCollection，其中包含這筆記錄所應使用的保留區。

傳回

SequenceNumber

已附加之記錄的序號。

例外狀況

ArgumentException

一或多個引數無效。

IOException

附加記錄時發生 I/O 錯誤。

SequenceFullException

記錄順序無法騰出足夠的可用空間來容納新的記錄。

ObjectDisposedException

已在處置序列之後呼叫此方法。

備註

包含在 data 參數中的資料將串連至單一位元組陣列中，以便附加成記錄。 不過，在讀取記錄時，並不會將資料分割回陣列區段。

附加的記錄將會使用 reservations 參數指定的保留區，以取用先前所保留的空間。 如果附加成功，則會使用可以保存資料的最小保留區域，而且該保留區域將會從集合移除。

此方法通常會在寫入記錄前完成。 若要確定已寫入某筆記錄，請使用 ForceFlush 參數指定 recordAppendOptions 旗標，或是呼叫 Flush 方法。

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

在衍生類別中覆寫時，使用之前在順序中保留的空間，將記錄檔記錄附加到 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, 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

參數

data

IList<ArraySegment<Byte>>

即將串連並附加成記錄之位元組陣列區段的清單。

nextUndoRecord

SequenceNumber

下一筆記錄的序號 (依照使用者指定的順序)。

previousRecord

SequenceNumber

下一筆記錄的序號 (依照之前的順序)。

recordAppendOptions

RecordAppendOptions

RecordAppendOptions 的有效值，其中指定資料的寫入方式。

reservations

ReservationCollection

ReservationCollection，其中包含這筆記錄所應使用的保留區。

傳回

SequenceNumber

已附加之記錄的序號。

例外狀況

ArgumentException

一或多個引數無效。

IOException

附加記錄時發生 I/O 錯誤。

SequenceFullException

記錄順序無法騰出足夠的可用空間來容納新的記錄。

ObjectDisposedException

已在處置序列之後呼叫此方法。

備註

包含在 data 參數中的資料將串連至單一位元組陣列中，以便附加成記錄。 不過，在讀取記錄時，並不會將資料分割回陣列區段。

附加的記錄將會使用 reservations 參數指定的保留區，以取用先前所保留的空間。 如果附加成功，則會使用可以保存資料的最小保留區域，而且該保留區域將會從集合移除。

此方法通常會在寫入記錄前完成。 若要確定已寫入某筆記錄，請使用 ForceFlush 參數指定 recordAppendOptions 旗標，或是呼叫 Flush 方法。