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 方法。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈