IRecordSequence.Append メソッド

定義

名前空間:

System.IO.Log

アセンブリ:

System.IO.Log.dll

派生クラスでオーバーライドされると、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.SequenceNumber

Public 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 の有効な値。

戻り値

SequenceNumber

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

例外

ArgumentException

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

IOException

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

SequenceFullException

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

ObjectDisposedException

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

注釈

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.SequenceNumber

Public 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 の有効な値。

戻り値

SequenceNumber

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

例外

ArgumentException

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

IOException

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

SequenceFullException

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

ObjectDisposedException

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

注釈

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.SequenceNumber

Public 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。

戻り値

SequenceNumber

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

例外

ArgumentException

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

IOException

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

SequenceFullException

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

ObjectDisposedException

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

注釈

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.SequenceNumber

Public 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。

戻り値

SequenceNumber

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

例外

ArgumentException

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

IOException

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

SequenceFullException

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

ObjectDisposedException

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

注釈

data パラメーターに格納されたデータは、レコードとして追加するために単一バイトの配列に連結されます。 ただし、レコードの読み取り時にデータを分割して配列セグメントに戻す準備は実施されません。

追加されたレコードは、reservations パラメーターにより指定された予約を使用して以前に予約された領域を消費します。 この追加処理が成功すると、データを格納できる最も小さな予約領域が消費され、その予約領域がコレクションから削除されます。

このメソッドは通常、レコードの書き込みが終わる前に完了します。 レコードが書き込まれたことを確認するために、ForceFlush パラメーターを使用して recordAppendOptions フラグを指定するか、Flush メソッドを呼び出します。