IRecordSequence.BeginAppend Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе начинает асинхронную операцию добавления.
Перегрузки
| Имя | Описание |
|---|---|
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
При переопределении в производном классе начинает асинхронную операцию добавления, используя пространство, ранее зарезервированное в последовательности. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
При переопределении в производном классе начинает асинхронную операцию добавления с помощью пространства, ранее зарезервированного в последовательности. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
При переопределении в производном классе начинает асинхронную операцию добавления. |
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
При переопределении в производном классе начинает асинхронную операцию добавления, используя пространство, ранее зарезервированное в последовательности. |
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
При переопределении в производном классе начинает асинхронную операцию добавления, используя пространство, ранее зарезервированное в последовательности.
public:
IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousUndoRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginAppend(System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousUndoRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations, AsyncCallback callback, object state);abstract member BeginAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResultPublic Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousUndoRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResultПараметры
- data
- IList<ArraySegment<Byte>>
Список сегментов массива байтов, которые будут сцеплены и добавлены в качестве записи.
- nextUndoRecord
- SequenceNumber
Порядковый номер следующей записи в указанном пользователем порядке.
- previousUndoRecord
- SequenceNumber
Порядковый номер следующей записи в предыдущем порядке.
- recordAppendOptions
- RecordAppendOptions
Допустимое значение RecordAppendOptions , указывающее, как должны быть записаны данные.
- reservations
- ReservationCollection
Объект, ReservationCollection содержащий резервирование, которое должно использоваться для этой записи.
- callback
- AsyncCallback
Необязательный асинхронный обратный вызов, вызываемый при завершении добавления.
- state
- Object
Предоставленный пользователем объект, который отличает этот конкретный асинхронный запрос на добавление от других запросов.
Возвращаемое значение
Объект, IAsyncResult представляющий асинхронное добавление, которое по-прежнему может быть ожидающим.
Исключения
Один или несколько аргументов являются недопустимыми.
При добавлении записи произошла ошибка ввода-вывода.
Последовательность записей не могла сделать достаточно свободного места, чтобы содержать новую запись.
Метод был вызван после удаления последовательности.
Комментарии
Необходимо передать IAsyncResult возвращенный этим методом методу EndAppend , чтобы убедиться, что операция добавления завершена, и ресурсы можно освободить соответствующим образом. Если во время асинхронного добавления произошла ошибка, исключение не возникает, пока EndAppend метод не вызывается с IAsyncResult возвращаемым этим методом.
Данные, содержащиеся в параметре data , будут объединяться в один массив байтов для добавления в качестве записи. Однако при чтении записи не выполняется подготовка для разделения данных обратно на сегменты массива.
Добавленная запись будет использовать пространство, ранее зарезервированное с помощью резервирования, указанного параметром reservations . Если добавление успешно выполнено, оно будет использовать наименьшую область резервирования, которая может содержать данные, и эта область резервирования будет удалена из коллекции.
Как правило, этот метод завершается до записи. Чтобы убедиться, что запись была записана, укажите ForceFlush флаг с помощью recordAppendOptions параметра или вызовите Flush метод.
Применяется к
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
При переопределении в производном классе начинает асинхронную операцию добавления с помощью пространства, ранее зарезервированного в последовательности.
public:
IAsyncResult ^ BeginAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginAppend(ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations, AsyncCallback callback, object state);abstract member BeginAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResultPublic Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResultПараметры
- data
- ArraySegment<Byte>
Список сегментов массива байтов, которые будут сцеплены и добавлены в качестве записи.
- nextUndoRecord
- SequenceNumber
Порядковый номер следующей записи в указанном пользователем порядке.
- previousRecord
- SequenceNumber
Порядковый номер следующей записи в предыдущем порядке.
- recordAppendOptions
- RecordAppendOptions
Допустимое значение RecordAppendOptions , указывающее, как должны быть записаны данные.
- reservations
- ReservationCollection
Объект, ReservationCollection содержащий резервирование, которое должно использоваться для этой записи.
- callback
- AsyncCallback
Необязательный асинхронный обратный вызов, вызываемый при завершении добавления.
- state
- Object
Предоставленный пользователем объект, который отличает этот конкретный асинхронный запрос на добавление от других запросов.
Возвращаемое значение
Объект, IAsyncResult представляющий асинхронное добавление, которое по-прежнему может быть ожидающим.
Исключения
Один или несколько аргументов являются недопустимыми.
При добавлении записи произошла ошибка ввода-вывода.
Последовательность записей не могла сделать достаточно свободного места, чтобы содержать новую запись.
Метод был вызван после удаления последовательности.
Комментарии
Необходимо передать IAsyncResult возвращенный этим методом методу EndAppend , чтобы убедиться, что операция добавления завершена, и ресурсы можно освободить соответствующим образом. Если во время асинхронного добавления произошла ошибка, исключение не возникает, пока EndAppend метод не вызывается с IAsyncResult возвращаемым этим методом.
Данные, содержащиеся в параметре data , будут объединяться в один массив байтов для добавления в качестве записи. Однако при чтении записи не выполняется подготовка для разделения данных обратно на сегменты массива.
Добавленная запись будет использовать пространство, ранее зарезервированное с помощью резервирования, указанного параметром reservations . Если добавление успешно выполнено, оно будет использовать наименьшую область резервирования, которая может содержать данные, и эта область резервирования будет удалена из коллекции.
Как правило, этот метод завершается до записи. Чтобы убедиться, что запись была записана, укажите ForceFlush флаг с помощью recordAppendOptions параметра или вызовите Flush метод.
Применяется к
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
При переопределении в производном классе начинает асинхронную операцию добавления.
public:
IAsyncResult ^ BeginAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginAppend(ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, AsyncCallback callback, object state);abstract member BeginAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * AsyncCallback * obj -> IAsyncResultPublic Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResultПараметры
- data
- ArraySegment<Byte>
Список сегментов массива байтов, которые будут сцеплены и добавлены в качестве записи.
- nextUndoRecord
- SequenceNumber
Порядковый номер следующей записи в указанном пользователем порядке.
- previousRecord
- SequenceNumber
Порядковый номер следующей записи в предыдущем порядке.
- recordAppendOptions
- RecordAppendOptions
Допустимое значение RecordAppendOptions , указывающее, как должны быть записаны данные.
- callback
- AsyncCallback
Необязательный асинхронный обратный вызов, вызываемый при завершении добавления.
- state
- Object
Предоставленный пользователем объект, который отличает этот конкретный асинхронный запрос на добавление от других запросов.
Возвращаемое значение
Объект, IAsyncResult представляющий асинхронное добавление, которое по-прежнему может быть ожидающим.
Исключения
Один или несколько аргументов являются недопустимыми.
При добавлении записи произошла ошибка ввода-вывода.
Последовательность записей не могла сделать достаточно свободного места, чтобы содержать новую запись.
Метод был вызван после удаления последовательности.
Комментарии
Необходимо передать IAsyncResult возвращенный этим методом методу EndAppend , чтобы убедиться, что операция добавления завершена, и ресурсы можно освободить соответствующим образом. Если во время асинхронного добавления произошла ошибка, исключение не возникает, пока EndAppend метод не вызывается с IAsyncResult возвращаемым этим методом.
Данные, содержащиеся в параметре data , будут объединяться в один массив байтов для добавления в качестве записи. Однако при чтении записи не выполняется подготовка для разделения данных обратно на сегменты массива.
Как правило, этот метод завершается до записи. Чтобы убедиться, что запись была записана, укажите ForceFlush флаг с помощью recordAppendOptions параметра или вызовите Flush метод.
Применяется к
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
При переопределении в производном классе начинает асинхронную операцию добавления, используя пространство, ранее зарезервированное в последовательности.
public:
IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginAppend(System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, AsyncCallback callback, object state);abstract member BeginAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * AsyncCallback * obj -> IAsyncResultPublic Function BeginAppend (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResultПараметры
- data
- IList<ArraySegment<Byte>>
Список сегментов массива байтов, которые будут сцеплены и добавлены в качестве записи.
- nextUndoRecord
- SequenceNumber
Порядковый номер следующей записи в указанном пользователем порядке.
- previousRecord
- SequenceNumber
Порядковый номер следующей записи в предыдущем порядке.
- recordAppendOptions
- RecordAppendOptions
Допустимое значение RecordAppendOptions , указывающее, как должны быть записаны данные.
- callback
- AsyncCallback
Необязательный асинхронный обратный вызов, вызываемый при завершении добавления.
- state
- Object
Предоставленный пользователем объект, который отличает этот конкретный асинхронный запрос на добавление от других запросов.
Возвращаемое значение
Объект, IAsyncResult представляющий асинхронное добавление, которое по-прежнему может быть ожидающим.
Исключения
Один или несколько аргументов являются недопустимыми.
При добавлении записи произошла ошибка ввода-вывода.
Последовательность записей не могла сделать достаточно свободного места, чтобы содержать новую запись.
Метод был вызван после удаления последовательности.
Комментарии
Необходимо передать IAsyncResult возвращенный этим методом методу EndAppend , чтобы убедиться, что операция добавления завершена, и ресурсы можно освободить соответствующим образом. Если во время асинхронного добавления произошла ошибка, исключение не возникает, пока EndAppend метод не вызывается с IAsyncResult возвращаемым этим методом.
Данные, содержащиеся в параметре data , будут объединяться в один массив байтов для добавления в качестве записи. Однако при чтении записи не выполняется подготовка для разделения данных обратно на сегменты массива.
Как правило, этот метод завершается до записи. Чтобы убедиться, что запись была записана, укажите ForceFlush флаг с помощью recordAppendOptions параметра или вызовите Flush метод.
