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

Один или несколько аргументов являются недопустимыми.

IOException

При добавлении записи произошла ошибка ввода-вывода.

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

Один или несколько аргументов являются недопустимыми.

IOException

При добавлении записи произошла ошибка ввода-вывода.

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

Один или несколько аргументов являются недопустимыми.

IOException

При добавлении записи произошла ошибка ввода-вывода.

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

Один или несколько аргументов являются недопустимыми.

IOException

При добавлении записи произошла ошибка ввода-вывода.

SequenceFullException

Последовательность записей не могла сделать достаточно свободного места, чтобы содержать новую запись.

ObjectDisposedException

Метод был вызван после удаления последовательности.

Комментарии

Данные, содержащиеся в параметре data , будут объединяться в один массив байтов для добавления в качестве записи. Однако при чтении записи не выполняется подготовка для разделения данных обратно на сегменты массива.

Добавленная запись будет использовать пространство, ранее зарезервированное с помощью резервирования, указанного параметром reservations . Если добавление успешно выполнено, оно будет использовать наименьшую область резервирования, которая может содержать данные, и эта область резервирования будет удалена из коллекции.

Как правило, этот метод завершается до записи. Чтобы убедиться, что запись была записана, укажите ForceFlush флаг с помощью recordAppendOptions параметра или вызовите Flush метод.