FileRecordSequence.ReserveAndAppend メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
1 つの予約を自動的に行い、レコードをシーケンスに追加します。
オーバーロード
| 名前 | 説明 |
|---|---|
| ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[]) |
1 つの予約を自動的に行い、レコードをシーケンスに追加します。 このメソッドは継承できません。 |
| ReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[]) |
1 つの予約を自動的に行い、レコードをシーケンスに追加します。 このメソッドは継承できません。 |
ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])
1 つの予約を自動的に行い、レコードをシーケンスに追加します。 このメソッドは継承できません。
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[]
行う予約 (バイト単位)。
返品
追加されたログ レコードのシーケンス番号。
実装
例外
1 つ以上の引数が null。
1 つ以上の引数が範囲外です。
reservations は、このレコード シーケンスによって作成されませんでした。
レコード シーケンスが読み取り専用アクセスで開かれたため、操作を実行できません。
予期しない I/O 例外のため、要求を実行できませんでした。
シーケンスが破棄された後、メソッドが呼び出されました。
プログラムの実行を続行するのに十分なメモリがありません。
レコード シーケンスがいっぱいです。
注釈
data パラメーターに含まれるデータは、レコードとして追加するために 1 バイト配列に連結されます。 ただし、レコードの読み取り時にデータを配列セグメントに分割するためのプロビジョニングは行われません。
指定された予約は、レコード追加操作を使用してアトミック操作で指定された予約コレクションに追加されます。 追加に失敗した場合、領域は予約されません。
通常、このメソッドは、レコードが書き込まれる前に完了する可能性があります。 レコードが確実に書き込まれるようにするには、recordAppendOptions パラメーターを使用して ForceFlush フラグを指定するか、Flush メソッドを呼び出します。
適用対象
ReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])
1 つの予約を自動的に行い、レコードをシーケンスに追加します。 このメソッドは継承できません。
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
パラメーター
- data
- ArraySegment<Byte>
レコードとして連結および追加されるバイト配列セグメントのリスト。
- nextUndoRecord
- SequenceNumber
ユーザー指定の順序での次のレコードのシーケンス番号。
- previousRecord
- SequenceNumber
次のレコードのシーケンス番号 (前の順序)。
- recordAppendOptions
- RecordAppendOptions
データの書き込み方法を指定する RecordAppendOptions の有効な値。
- reservationCollection
- ReservationCollection
予約を行うコレクションを含む ReservationCollection 。
- reservations
- Int64[]
行う予約 (バイト単位)。
返品
追加されたログ レコードのシーケンス番号。
実装
例外
1 つ以上の引数が null。
1 つ以上の引数が範囲外です。
reservations は、このレコード シーケンスによって作成されませんでした。
レコード シーケンスが読み取り専用アクセスで開かれたため、操作を実行できません。
予期しない I/O 例外のため、要求を実行できませんでした。
シーケンスが破棄された後、メソッドが呼び出されました。
プログラムの実行を続行するのに十分なメモリがありません。
レコード シーケンスがいっぱいです。
注釈
data パラメーターに含まれるデータは、レコードとして追加するために 1 バイト配列に連結されます。 ただし、レコードの読み取り時にデータを配列セグメントに分割するためのプロビジョニングは行われません。
指定された予約は、レコード追加操作を使用してアトミック操作で指定された予約コレクションに追加されます。 追加に失敗した場合、領域は予約されません。
通常、このメソッドは、レコードが書き込まれる前に完了する可能性があります。 レコードが確実に書き込まれるようにするには、recordAppendOptions パラメーターを使用して ForceFlush フラグを指定するか、Flush メソッドを呼び出します。