IRecordSequence.BeginAppend Método

Definición

Cuando se invalida en una clase derivada, comienza una operación de anexo asincrónica.When overridden in a derived class, begins an asynchronous append operation.

Sobrecargas

BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)

Cuando se invalida en una clase derivada, comienza una operación de anexado asincrónica, utilizando el espacio previamente reservado en la secuencia.When overridden in a derived class, begins an asynchronous append operation, using space previously reserved in the sequence.

BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)

Cuando se invalida en una clase derivada, comienza una operación de anexado asincrónica, utilizando el espacio previamente reservado en la secuencia.When overridden in a derived class, begins an asynchronous append operation using space previously reserved in the sequence.

BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)

Cuando se invalida en una clase derivada, comienza una operación de anexo asincrónica.When overridden in a derived class, begins an asynchronous append operation.

BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)

Cuando se invalida en una clase derivada, comienza una operación de anexado asincrónica, utilizando el espacio previamente reservado en la secuencia.When overridden in a derived class, begins an asynchronous append operation, using space previously reserved in the sequence.

BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)

Cuando se invalida en una clase derivada, comienza una operación de anexado asincrónica, utilizando el espacio previamente reservado en la secuencia.When overridden in a derived class, begins an asynchronous append operation, using space previously reserved in the sequence.

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

Parámetros

data
IList<ArraySegment<Byte>>

Una lista de segmentos de la matriz de bytes que se concatenarán y anexarán como el registro.A list of byte array segments that will be concatenated and appended as the record.

nextUndoRecord
SequenceNumber

El número de secuencia del registro siguiente en el orden especificado por el usuario.The sequence number of the next record in the user-specified order.

previousUndoRecord
SequenceNumber

El número de secuencia del registro siguiente en orden anterior.The sequence number of the next record in Previous order.

recordAppendOptions
RecordAppendOptions

Un valor válido de RecordAppendOptions que especifica cómo se deberían escribir los datos.A valid value of RecordAppendOptions that specifies how the data should be written.

reservations
ReservationCollection

Una ReservationCollection que contiene la reserva que se debería utilizar para este registro.A ReservationCollection that contains the reservation that should be used for this record.

callback
AsyncCallback

Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado el anexado.An optional asynchronous callback, to be called when the append is complete.

state
Object

Objeto proporcionado por el usuario que distingue esta solicitud de anexado asincrónica de otras.A user-provided object that distinguishes this particular asynchronous append request from other requests.

Devoluciones

IAsyncResult

Objeto IAsyncResult que representa el anexado asincrónico, que puede hallarse aún pendiente.An IAsyncResult that represents the asynchronous append, which could still be pending.

Excepciones

Uno o varios argumentos no son válidos.One or more of the arguments is invalid.

Ha ocurrido un error de E/S al anexar un registro.An I/O error occurred while appending the record.

La secuencia del registro no pudo liberar espacio suficiente para contener el nuevo registro.The record sequence could not make enough free space to contain the new record.

Se llamó al método una vez eliminada la secuencia.The method was called after the sequence has been disposed of.

Comentarios

Debería pasar IAsyncResult devuelto por este método al método EndAppend para asegurarse que la operación de anexado ha finalizado y que se pueden liberar los recursos apropiadamente.You should pass the IAsyncResult returned by this method to the EndAppend method to ensure that the append operation has completed and resources can be freed appropriately. Si se ha producido un error durante el anexado asincrónico, no se produce una excepción hasta que se llame al método EndAppend con el IAsyncResult que devuelve este método.If an error has occurred during an asynchronous append, an exception is not thrown until the EndAppend method is called with the IAsyncResult returned by this method.

Los datos contenidos en el parámetro data se concatenarán en una matriz de bytes única para anexarlos como el registro.Data contained in the data parameter will be concatenated into a single byte array for appending as the record. Sin embargo, no se ha realizado ninguna disposición para dividir los datode nuevo en los segmentos de la matriz cuando se lee el registro.However, no provision is made for splitting data back into array segments when the record is read.

El registro anexado utilizará el espacio que se ha reservado previamente, utilizando una reserva especificada por el parámetro reservations.The appended record will consume space that has been previously reserved, using a reservation specified by the reservations parameter. Si el anexado tiene éxito, utilizará el área de reserva menor posible que pueda contener los datos y esa área de reserva se quitará de la colección.If the append succeeds, it will consume the smallest reservation area that can hold the data, and that reservation area will be removed from the collection.

Normalmente, este método se completa antes de que se haya escrito el registro.Normally, this method completes before the record has been written. Para asegurarse de que se ha escrito un registro, especifique la marca ForceFlush utilizando el parámetro recordAppendOptions o llame al método Flush.To ensure that a record has been written, either specify the ForceFlush flag using the recordAppendOptions parameter, or call the Flush method.

Se aplica a

BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)

Cuando se invalida en una clase derivada, comienza una operación de anexado asincrónica, utilizando el espacio previamente reservado en la secuencia.When overridden in a derived class, begins an asynchronous append operation using space previously reserved in the sequence.

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

Parámetros

data
ArraySegment<Byte>

Una lista de segmentos de la matriz de bytes que se concatenarán y anexarán como el registro.A list of byte array segments that will be concatenated and appended as the record.

nextUndoRecord
SequenceNumber

El número de secuencia del registro siguiente en el orden especificado por el usuario.The sequence number of the next record in the user-specified order.

previousRecord
SequenceNumber

El número de secuencia del registro siguiente en orden anterior.The sequence number of the next record in Previous order.

recordAppendOptions
RecordAppendOptions

Un valor válido de RecordAppendOptions que especifica cómo se deberían escribir los datos.A valid value of RecordAppendOptions that specifies how the data should be written.

reservations
ReservationCollection

Una ReservationCollection que contiene la reserva que se debería utilizar para este registro.A ReservationCollection that contains the reservation that should be used for this record.

callback
AsyncCallback

Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado el anexado.An optional asynchronous callback, to be called when the append is complete.

state
Object

Objeto proporcionado por el usuario que distingue esta solicitud de anexado asincrónica de otras.A user-provided object that distinguishes this particular asynchronous append request from other requests.

Devoluciones

IAsyncResult

Objeto IAsyncResult que representa el anexado asincrónico, que puede hallarse aún pendiente.An IAsyncResult that represents the asynchronous append, which could still be pending.

Excepciones

Uno o varios argumentos no son válidos.One or more of the arguments is invalid.

Ha ocurrido un error de E/S al anexar un registro.An I/O error occurred while appending the record.

La secuencia del registro no pudo liberar espacio suficiente para contener el nuevo registro.The record sequence could not make enough free space to contain the new record.

Se llamó al método una vez eliminada la secuencia.The method was called after the sequence has been disposed of.

Comentarios

Debería pasar IAsyncResult devuelto por este método al método EndAppend para asegurarse que la operación de anexado ha finalizado y que se pueden liberar los recursos apropiadamente.You should pass the IAsyncResult returned by this method to the EndAppend method to ensure that the append operation has completed and resources can be freed appropriately. Si se ha producido un error durante el anexado asincrónico, no se produce una excepción hasta que se llame al método EndAppend con el IAsyncResult que devuelve este método.If an error has occurred during an asynchronous append, an exception is not thrown until the EndAppend method is called with the IAsyncResult returned by this method.

Los datos contenidos en el parámetro data se concatenarán en una matriz de bytes única para anexarlos como el registro.Data contained in the data parameter will be concatenated into a single byte array for appending as the record. Sin embargo, no se ha realizado ninguna disposición para dividir los datode nuevo en los segmentos de la matriz cuando se lee el registro.However, no provision is made for splitting data back into array segments when the record is read.

El registro anexado utilizará el espacio que se ha reservado previamente, utilizando una reserva especificada por el parámetro reservations.The appended record will consume space that has been previously reserved, using a reservation specified by the reservations parameter. Si el anexado tiene éxito, utilizará el área de reserva menor posible que pueda contener los datos y esa área de reserva se quitará de la colección.If the append succeeds, it will consume the smallest reservation area that can hold the data, and that reservation area will be removed from the collection.

Normalmente, este método se completa antes de que se haya escrito el registro.Normally, this method completes before the record has been written. Para asegurarse de que se ha escrito un registro, especifique la marca ForceFlush utilizando el parámetro recordAppendOptions o llame al método Flush.To ensure that a record has been written, either specify the ForceFlush flag using the recordAppendOptions parameter, or call the Flush method.

Se aplica a

BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)

Cuando se invalida en una clase derivada, comienza una operación de anexo asincrónica.When overridden in a derived class, begins an asynchronous append operation.

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 -> IAsyncResult
Public Function BeginAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResult

Parámetros

data
ArraySegment<Byte>

Una lista de segmentos de la matriz de bytes que se concatenarán y anexarán como el registro.A list of byte array segments that will be concatenated and appended as the record.

nextUndoRecord
SequenceNumber

El número de secuencia del registro siguiente en el orden especificado por el usuario.The sequence number of the next record in the user-specified order.

previousRecord
SequenceNumber

El número de secuencia del registro siguiente en orden anterior.The sequence number of the next record in Previous order.

recordAppendOptions
RecordAppendOptions

Un valor válido de RecordAppendOptions que especifica cómo se deberían escribir los datos.A valid value of RecordAppendOptions that specifies how the data should be written.

callback
AsyncCallback

Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado el anexado.An optional asynchronous callback, to be called when the append is complete.

state
Object

Objeto proporcionado por el usuario que distingue esta solicitud de anexado asincrónica de otras.A user-provided object that distinguishes this particular asynchronous append request from other requests.

Devoluciones

IAsyncResult

Objeto IAsyncResult que representa el anexado asincrónico, que puede hallarse aún pendiente.An IAsyncResult that represents the asynchronous append, which could still be pending.

Excepciones

Uno o varios argumentos no son válidos.One or more of the arguments is invalid.

Ha ocurrido un error de E/S al anexar un registro.An I/O error occurred while appending the record.

La secuencia del registro no pudo liberar espacio suficiente para contener el nuevo registro.The record sequence could not make enough free space to contain the new record.

Se llamó al método una vez eliminada la secuencia.The method was called after the sequence has been disposed of.

Comentarios

Debería pasar IAsyncResult devuelto por este método al método EndAppend para asegurarse que la operación de anexado ha finalizado y que se pueden liberar los recursos apropiadamente.You should pass the IAsyncResult returned by this method to the EndAppend method to ensure that the append operation has completed and resources can be freed appropriately. Si se ha producido un error durante el anexado asincrónico, no se produce una excepción hasta que se llame al método EndAppend con el IAsyncResult que devuelve este método.If an error has occurred during an asynchronous append, an exception is not thrown until the EndAppend method is called with the IAsyncResult returned by this method.

Los datos contenidos en el parámetro data se concatenarán en una matriz de bytes única para anexarlos como el registro.Data contained in the data parameter will be concatenated into a single byte array for appending as the record. Sin embargo, no se ha realizado ninguna disposición para dividir los datode nuevo en los segmentos de la matriz cuando se lee el registro.However, no provision is made for splitting data back into array segments when the record is read.

Normalmente, este método se completa antes de que se haya escrito el registro.Normally, this method completes before the record has been written. Para asegurarse de que se ha escrito un registro, especifique la marca ForceFlush utilizando el parámetro recordAppendOptions o llame al método Flush.To ensure that a record has been written, either specify the ForceFlush flag using the recordAppendOptions parameter, or call the Flush method.

Se aplica a

BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)

Cuando se invalida en una clase derivada, comienza una operación de anexado asincrónica, utilizando el espacio previamente reservado en la secuencia.When overridden in a derived class, begins an asynchronous append operation, using space previously reserved in the sequence.

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

Parámetros

data
IList<ArraySegment<Byte>>

Una lista de segmentos de la matriz de bytes que se concatenarán y anexarán como el registro.A list of byte array segments that will be concatenated and appended as the record.

nextUndoRecord
SequenceNumber

El número de secuencia del registro siguiente en el orden especificado por el usuario.The sequence number of the next record in the user-specified order.

previousRecord
SequenceNumber

El número de secuencia del registro siguiente en orden anterior.The sequence number of the next record in Previous order.

recordAppendOptions
RecordAppendOptions

Un valor válido de RecordAppendOptions que especifica cómo se deberían escribir los datos.A valid value of RecordAppendOptions that specifies how the data should be written.

callback
AsyncCallback

Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado el anexado.An optional asynchronous callback, to be called when the append is complete.

state
Object

Objeto proporcionado por el usuario que distingue esta solicitud de anexado asincrónica de otras.A user-provided object that distinguishes this particular asynchronous append request from other requests.

Devoluciones

IAsyncResult

Objeto IAsyncResult que representa el anexado asincrónico, que puede hallarse aún pendiente.An IAsyncResult that represents the asynchronous append, which could still be pending.

Excepciones

Uno o varios argumentos no son válidos.One or more of the arguments is invalid.

Ha ocurrido un error de E/S al anexar un registro.An I/O error occurred while appending the record.

La secuencia del registro no pudo liberar espacio suficiente para contener el nuevo registro.The record sequence could not make enough free space to contain the new record.

Se llamó al método una vez eliminada la secuencia.The method was called after the sequence has been disposed of.

Comentarios

Debería pasar IAsyncResult devuelto por este método al método EndAppend para asegurarse que la operación de anexado ha finalizado y que se pueden liberar los recursos apropiadamente.You should pass the IAsyncResult returned by this method to the EndAppend method to ensure that the append operation has completed and resources can be freed appropriately. Si se ha producido un error durante el anexado asincrónico, no se produce una excepción hasta que se llame al método EndAppend con el IAsyncResult que devuelve este método.If an error has occurred during an asynchronous append, an exception is not thrown until the EndAppend method is called with the IAsyncResult returned by this method.

Los datos contenidos en el parámetro data se concatenarán en una matriz de bytes única para anexarlos como el registro.Data contained in the data parameter will be concatenated into a single byte array for appending as the record. Sin embargo, no se ha realizado ninguna disposición para dividir los datode nuevo en los segmentos de la matriz cuando se lee el registro.However, no provision is made for splitting data back into array segments when the record is read.

Normalmente, este método se completa antes de que se haya escrito el registro.Normally, this method completes before the record has been written. Para asegurarse de que se ha escrito un registro, especifique la marca ForceFlush utilizando el parámetro recordAppendOptions o llame al método Flush.To ensure that a record has been written, either specify the ForceFlush flag using the recordAppendOptions parameter, or call the Flush method.

Se aplica a