FileRecordSequence.ReserveAndAppend 方法

定义

命名空间:: System.IO.Log

程序集:: System.IO.Log.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

自动创建单个预留，并将记录追加到序列中。

重载

名称	说明
ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])	自动创建单个预留，并将记录追加到序列中。无法继承此方法。
ReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])	自动创建单个预留，并将记录追加到序列中。无法继承此方法。

ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

自动创建单个预留，并将记录追加到序列中。无法继承此方法。

public:
 virtual System::IO::Log::SequenceNumber ReserveAndAppend(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 ^ reservationCollection, ... cli::array <long> ^ reservations);

public System.IO.Log.SequenceNumber ReserveAndAppend(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 reservationCollection, params long[] reservations);

abstract member ReserveAndAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] -> System.IO.Log.SequenceNumber
override this.ReserveAndAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] -> System.IO.Log.SequenceNumber

Public Function ReserveAndAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, ParamArray reservations As Long()) As SequenceNumber

参数

data: IList<ArraySegment<Byte>>

将连接并追加为记录的字节数组段的列表。

nextUndoRecord: SequenceNumber

用户指定顺序中的下一条记录的序列号。

previousRecord: SequenceNumber

上一个顺序中的下一条记录的序列号。

recordAppendOptions: RecordAppendOptions

一个有效值 RecordAppendOptions ，该值指定应如何写入数据。

reservationCollection: ReservationCollection

要在其中进行预留的预留集合。

reservations: Int64[]

要做出的预留（以字节为单位）。

SequenceNumber

追加的日志记录的序列号。

实现

ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

例外

ArgumentNullException

一个或多个参数是 null。

ArgumentOutOfRangeException

一个或多个参数处于范围外。

ArgumentException

reservations 不是由此记录序列创建的。

NotSupportedException

无法执行该操作，因为记录序列是使用只读访问权限打开的。

IOException

由于出现意外的 I/O 异常，无法执行请求。

ObjectDisposedException

在释放序列后调用了该方法。

OutOfMemoryException

没有足够的内存继续执行程序。

SequenceFullException

记录序列已满。

注解

参数中包含的 data 数据将串联成单个字节数组，以追加为记录。但是，在读取记录时，不会设置将数据拆分回数组段。

指定的预留将添加到具有记录追加操作的原子操作中提供的预留集合。如果追加失败，则不保留任何空间。

通常，此方法可能在写入记录之前完成。若要确保已写入记录，请使用参数指定 ForceFlush 标志 recordAppendOptions 或调用 Flush 该方法。

适用于

ReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

自动创建单个预留，并将记录追加到序列中。无法继承此方法。

public:
 virtual System::IO::Log::SequenceNumber ReserveAndAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservationCollection, ... cli::array <long> ^ reservations);

public System.IO.Log.SequenceNumber ReserveAndAppend(ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservationCollection, params long[] reservations);

abstract member ReserveAndAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] -> System.IO.Log.SequenceNumber
override this.ReserveAndAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] -> System.IO.Log.SequenceNumber

Public Function ReserveAndAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, ParamArray reservations As Long()) As SequenceNumber