LogRecordSequence.Append 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将日志记录写入 IRecordSequence。
重载
示例
此示例演示如何使用 Append 成员。
// Append records. Appending three records.
public void AppendRecords()
{
Console.WriteLine("Appending Log Records...");
SequenceNumber previous = SequenceNumber.Invalid;
previous = sequence.Append(CreateData("Hello World!"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);
previous = sequence.Append(CreateData("This is my first Logging App"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);
previous = sequence.Append(CreateData("Using LogRecordSequence..."), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush);
Console.WriteLine("Done...");
}
' Append records. Appending three records.
Public Sub AppendRecords()
Console.WriteLine("Appending Log Records...")
Dim previous As SequenceNumber = SequenceNumber.Invalid
previous = sequence.Append(CreateData("Hello World!"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush)
previous = sequence.Append(CreateData("This is my first Logging App"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush)
previous = sequence.Append(CreateData("Using LogRecordSequence..."), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush)
Console.WriteLine("Done...")
End Sub
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)
使用序列中先前保留的空间向 IRecordSequence 中追加日志记录。 无法继承此方法。
public:
virtual 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
override this.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，它包含应当用于此记录的预留。
返回
追加的日志记录的序列号。
实现
例外
userRecord 或 previousRecord 对此序列无效。
- 或 -
无法追加 data，原因是它比最大记录大小要大。
- 或 -
reservations 不是由此记录序列创建的。
一个或多个参数为 null。
userRecord 或 previousRecord 不在此序列的基序列号和最新序列号之间。
由于记录序列是通过只读访问权限打开的，因此无法执行该操作。
该方法是在序列已释放之后调用的。
没有足够的内存来继续执行该程序。
记录序列已满。
操作系统拒绝了对指定的日志序列的访问。
在 data 中找不到足以容纳 reservations 的预留。
注解
包含在 data 参数中的数据将连接成单个字节数组，以便以记录形式追加。 但在读取记录时，无法将数据重新拆分为数组段。
追加的记录将使用 reservations 参数指定的预留来占用先前已预留的空间。 如果追加成功，它将占用能容纳数据的最小预留区域，而该预留区域将从集合中移除。
通常，此方法在写入记录之前完成。 若要确保记录已写入，请使用 ForceFlush 参数指定 recordAppendOptions 标志，或者调用 Flush 方法。
适用于
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)
使用序列中先前保留的空间向 IRecordSequence 中追加日志记录。 无法继承此方法。
public:
virtual System::IO::Log::SequenceNumber Append(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber userRecord, 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 userRecord, 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
override this.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)), userRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumber参数
- data
- IList<ArraySegment<Byte>>
将连接在一起并以记录形式追加的字节数组段的列表。
- userRecord
- SequenceNumber
用户指定顺序中下一条记录的序列号。
- previousRecord
- SequenceNumber
“上一个”顺序中下一条记录的序列号。
- recordAppendOptions
- RecordAppendOptions
RecordAppendOptions 的一个有效值，用于指定应如何写入数据。
- reservations
- ReservationCollection
一个 ReservationCollection，它包含应当用于此记录的预留。
返回
追加的日志记录的序列号。
实现
例外
userRecord 或 previousRecord 对此序列无效。
- 或 -
无法追加 data，原因是它比最大记录大小要大。
- 或 -
reservations 不是由此记录序列创建的。
一个或多个参数为 null。
userRecord 或 previousRecord 不在此序列的基序列号和最新序列号之间。
由于记录序列是通过只读访问权限打开的，因此无法执行该操作。
该方法是在序列已释放之后调用的。
没有足够的内存来继续执行该程序。
记录序列已满。
操作系统拒绝了对指定的日志序列的访问。
在 data 中找不到足以容纳 reservations 的预留。
注解
包含在 data 参数中的数据将连接成单个字节数组，以便以记录形式追加。 但在读取记录时，无法将数据重新拆分为数组段。
追加的记录将使用 reservations 参数指定的预留来占用先前已预留的空间。 如果追加成功，它将占用能容纳数据的最小预留区域，而该预留区域将从集合中移除。
通常，此方法在写入记录之前完成。 若要确保记录已写入，请使用 ForceFlush 参数指定 recordAppendOptions 标志，或者调用 Flush 方法。
适用于
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)
将日志记录写入 LogRecordSequence。 无法继承此方法。
public:
virtual 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
override this.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 的一个有效值，用于指定应如何写入数据。
返回
追加的日志记录的序列号。
实现
例外
userRecord 或 previousRecord 对此序列无效。
- 或 -
无法追加 data，原因是它比最大记录大小要大。
- 或 -
reservations 不是由此记录序列创建的。
一个或多个参数为 null。
userRecord 或 previousRecord 不在此序列的基序列号和最新序列号之间。
由于记录序列是通过只读访问权限打开的，因此无法执行该操作。
该方法是在序列已释放之后调用的。
没有足够的内存来继续执行该程序。
记录序列已满。
操作系统拒绝了对指定的日志序列的访问。
示例
下面的示例演示如何使用此方法向序列中追加日志记录。
// Start Appending in two streams with interleaving appends.
SequenceNumber previous1 = SequenceNumber.Invalid;
SequenceNumber previous2 = SequenceNumber.Invalid;
Console.WriteLine("Appending interleaving records in stream1 and stream2...");
Console.WriteLine();
// Append two records in stream1.
previous1 = sequence1.Append(
CreateData("MyLogStream1: Hello World!"),
SequenceNumber.Invalid,
SequenceNumber.Invalid,
RecordAppendOptions.ForceFlush);
previous1 = sequence1.Append(
CreateData("MyLogStream1: This is my first Logging App"),
previous1,
previous1,
RecordAppendOptions.ForceFlush);
// Append two records in stream2.
previous2 = sequence2.Append(
CreateData("MyLogStream2: Hello World!"),
SequenceNumber.Invalid,
SequenceNumber.Invalid,
RecordAppendOptions.ForceFlush);
previous2 = sequence2.Append(
CreateData("MyLogStream2: This is my first Logging App"),
previous2,
previous2,
RecordAppendOptions.ForceFlush);
// Append the third record in stream1.
previous1 = sequence1.Append(CreateData(
"MyLogStream1: Using LogRecordSequence..."),
previous1,
previous1,
RecordAppendOptions.ForceFlush);
// Append the third record in stream2.
previous2 = sequence2.Append(
CreateData("MyLogStream2: Using LogRecordSequence..."),
previous2,
previous2,
RecordAppendOptions.ForceFlush);
' Start Appending in two streams with interleaving appends.
Dim previous1 As SequenceNumber = SequenceNumber.Invalid
Dim previous2 As SequenceNumber = SequenceNumber.Invalid
Console.WriteLine("Appending interleaving records in stream1 and stream2...")
Console.WriteLine()
' Append two records in stream1.
previous1 = sequence1.Append(CreateData("MyLogStream1: Hello World!"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush)
previous1 = sequence1.Append(CreateData("MyLogStream1: This is my first Logging App"), previous1, previous1, RecordAppendOptions.ForceFlush)
' Append two records in stream2.
previous2 = sequence2.Append(CreateData("MyLogStream2: Hello World!"), SequenceNumber.Invalid, SequenceNumber.Invalid, RecordAppendOptions.ForceFlush)
previous2 = sequence2.Append(CreateData("MyLogStream2: This is my first Logging App"), previous2, previous2, RecordAppendOptions.ForceFlush)
' Append the third record in stream1.
previous1 = sequence1.Append(CreateData("MyLogStream1: Using LogRecordSequence..."), previous1, previous1, RecordAppendOptions.ForceFlush)
' Append the third record in stream2.
previous2 = sequence2.Append(CreateData("MyLogStream2: Using LogRecordSequence..."), previous2, previous2, RecordAppendOptions.ForceFlush)
注解
包含在 data 参数中的数据将连接成单个字节数组，以便以记录形式追加。 但在读取记录时，无法将数据重新拆分为数组段。
通常，此方法在写入记录之前完成。 若要确保记录已写入，请使用 ForceFlush 参数指定 recordAppendOptions 标志，或者调用 Flush 方法。
适用于
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)
向 IRecordSequence 中追加日志记录。 无法继承此方法。
public:
virtual System::IO::Log::SequenceNumber Append(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber userRecord, 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 userRecord, 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
override this.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)), userRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumber参数
- data
- IList<ArraySegment<Byte>>
将连接在一起并以记录形式追加的字节数组段的列表。
- userRecord
- SequenceNumber
用户指定顺序中下一条记录的序列号。
- previousRecord
- SequenceNumber
“上一个”顺序中下一条记录的序列号。
- recordAppendOptions
- RecordAppendOptions
RecordAppendOptions 的一个有效值，用于指定应如何写入数据。
返回
追加的日志记录的序列号。
实现
例外
userRecord 或 previousRecord 对此序列无效。
- 或 -
无法追加 data，原因是它比最大记录大小要大。
- 或 -
reservations 不是由此记录序列创建的。
一个或多个参数为 null。
userRecord 或 previousRecord 不在此序列的基序列号和最新序列号之间。
由于记录序列是通过只读访问权限打开的，因此无法执行该操作。
该方法是在序列已释放之后调用的。
没有足够的内存来继续执行该程序。
记录序列已满。
操作系统拒绝了对指定的日志序列的访问。
注解
包含在 data 参数中的数据将连接成单个字节数组，以便以记录形式追加。 但在读取记录时，无法将数据重新拆分为数组段。
通常，此方法在写入记录之前完成。 若要确保记录已写入，请使用 ForceFlush 参数指定 recordAppendOptions 标志，或者调用 Flush 方法。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈