IRecordSequence.Append 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當在派生類別中被覆寫時，會將日誌記錄寫入 IRecordSequence。
多載
| 名稱 | Description |
|---|---|
| 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.SequenceNumberPublic 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 會指定資料應該如何寫入。
傳回
附加日誌記錄的序號。
例外狀況
一或多個引數無效。
在附加記錄時發生了 I/O 錯誤。
記錄序列無法產生足夠的空閒空間來容納新記錄。
該方法是在序列被處理後才被呼叫的。
備註
參數中 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.SequenceNumberPublic 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 會指定資料應該如何寫入。
傳回
附加日誌記錄的序號。
例外狀況
一或多個引數無效。
在附加記錄時發生了 I/O 錯誤。
記錄序列無法產生足夠的空閒空間來容納新記錄。
該方法是在序列被處理後才被呼叫的。
備註
參數中 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.SequenceNumberPublic 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 A，其中包含本紀錄應使用的保留條件。
傳回
附加日誌記錄的序號。
例外狀況
一或多個引數無效。
在附加記錄時發生了 I/O 錯誤。
記錄序列無法產生足夠的空閒空間來容納新記錄。
該方法是在序列被處理後才被呼叫的。
備註
參數中 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.SequenceNumberPublic 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 A，其中包含本紀錄應使用的保留條件。
傳回
附加日誌記錄的序號。
例外狀況
一或多個引數無效。
在附加記錄時發生了 I/O 錯誤。
記錄序列無法產生足夠的空閒空間來容納新記錄。
該方法是在序列被處理後才被呼叫的。
備註
參數中 data 包含的資料會被串接成一個位元組陣列，作為記錄附加。 然而，讀取記錄時並未提供將資料分割回陣列區段的機制。
附加的記錄會利用先前已保留的空間，並依參數 reservations 指定保留。 如果附加成功，將佔用能容納資料的最小保留區，該保留區將從集合中移除。
通常，此方法會在紀錄寫入前完成。 為了確保記錄已被寫入，請使用參數ForceFlush指定旗標，recordAppendOptions或呼叫該Flush方法。
