LogRecordSequence.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 userRecord, 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 userRecord, 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)), userRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, ParamArray reservations As Long()) As SequenceNumber

パラメーター

data: IList<ArraySegment<Byte>>

レコードとして連結および追加されるバイト配列セグメントのリスト。

userRecord: SequenceNumber

ユーザー指定の順序で次のレコードのシーケンス番号。

previousRecord: SequenceNumber

以前の順序で次のレコードのシーケンス番号。

recordAppendOptions: RecordAppendOptions

データの書き込み方法を指定する RecordAppendOptions の有効な値。

reservationCollection: ReservationCollection

予約を作成する予約コレクション。

reservations: Int64[]

作成する予約のバイト数。

戻り値

SequenceNumber

追加されたログレコードのシーケンス番号。

実装

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

例外

ArgumentException

1 つ以上の引数が無効です。

IOException

レコードの追加時に I/O エラーが発生しました。

SequenceFullException

レコードシーケンスは、新しいレコードの格納または予約のための十分な空き領域を作成できませんでした。

ObjectDisposedException

シーケンスが破棄された後にメソッドが呼び出されました。

ArgumentNullException

1 つ以上の引数が null です。

ArgumentOutOfRangeException

userRecord または previousRecord が、このシーケンスの基本シーケンス番号と最後のシーケンス番号との間にありません。

NotSupportedException

レコードシーケンスが読み取り専用アクセスで開かれているため、操作を実行できません。

OutOfMemoryException

プログラムの実行を継続する十分なメモリがありません。

UnauthorizedAccessException

指定のログシーケンスへのアクセスは、オペレーティングシステムにより拒否されました。

ReservationNotFoundException

data に対応する十分なサイズの予約が reservations に見つかりません。

注釈

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

パラメーター

data: ArraySegment<Byte>

レコードとして連結および追加されるバイト配列セグメントのリスト。

nextUndoRecord: SequenceNumber

ユーザー指定の順序で次のレコードのシーケンス番号。

previousRecord: SequenceNumber

以前の順序で次のレコードのシーケンス番号。

recordAppendOptions: RecordAppendOptions

データの書き込み方法を指定する RecordAppendOptions の有効な値。

reservationCollection: ReservationCollection

予約を作成するコレクションを格納する ReservationCollection。

reservations: Int64[]

作成する予約のバイト数。

戻り値

SequenceNumber

追加されたログレコードのシーケンス番号。

実装

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

例外

ArgumentException

このシーケンスの nextUndoRecord または previousRecord が有効ではありません。

- または -

data が最大レコードサイズより大きいため、追加できません。

- または -

reservations が、このレコードシーケンスによって作成されていません。

ArgumentNullException

1 つ以上の引数が null です。

ArgumentOutOfRangeException

nextUndoRecord または previousRecord が、このシーケンスの基本シーケンス番号と最後のシーケンス番号との間にありません。

IOException

予期しない I/O 例外のため、要求は実行されませんでした。

- または -

I/O デバイスエラーのため、要求は実行されませんでした。

NotSupportedException

レコードシーケンスが読み取り専用アクセスで開かれているため、操作を実行できません。

ObjectDisposedException

シーケンスが破棄された後にメソッドが呼び出されました。

OutOfMemoryException

プログラムの実行を継続する十分なメモリがありません。

SequenceFullException

レコードシーケンスがいっぱいです。

UnauthorizedAccessException

指定のログシーケンスへのアクセスは、オペレーティングシステムにより拒否されました。

ReservationNotFoundException

data に対応する十分なサイズの予約が reservations に見つかりません。

例

このメソッドを使用して予約を作成する方法を次の例に示します。このタスクは、CLFS ベースの LogRecordSequence クラスを使用している場合のみ実行できることに注意してください。

ReservationCollection reservations = recordSequence.CreateReservationCollection();  
long[] lengthOfUndoRecords = new long[] { 1000 };  
recordSequence.ReserveAndAppend(recordData,  
                                                     userSqn,  
                                                     previousSqn,  
                                                     RecordSequenceAppendOptions.None,  
                                                     reservations,  
                                                     lengthOfUndoRecords);  
recordSequence.Append(undoRecordData,    // If necessary …  
                                    userSqn,  
                                    previousSqn,  
                                    RecordSequenceAppendOptions.ForceFlush,  
                                    reservations);

注釈

適用対象

次の方法で共有

LogRecordSequence.ReserveAndAppend メソッド

定義

オーバーロード

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

パラメーター

戻り値

実装

例外

注釈

適用対象

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

パラメーター

戻り値

実装

例外

例

注釈

適用対象

その他のリソース