IRecordSequence.Append 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在派生类中重写时，将日志记录写入该 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.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 包含应用于此记录的预留。
返回
追加的日志记录的序列号。
例外
一个或多个自变量无效。
追加记录时发生 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 包含应用于此记录的预留。
返回
追加的日志记录的序列号。
例外
一个或多个自变量无效。
追加记录时发生 I/O 错误。
记录序列无法提供足够的可用空间来包含新记录。
在释放序列后调用了该方法。
注解
参数中包含的 data 数据将串联成单个字节数组，以追加为记录。 但是，在读取记录时，不会设置将数据拆分回数组段。
追加的记录将使用参数指定的 reservations 预留来占用以前保留的空间。 如果追加成功，它将使用可以保存数据的最小预留区域，并将从集合中删除该预留区域。
通常，此方法在写入记录之前完成。 若要确保已写入记录，请使用参数指定 ForceFlush 标志 recordAppendOptions 或调用 Flush 该方法。
