IRecordSequence.BeginWriteRestartArea Método

Definición

Cuando se invalida en una clase derivada, comienza una operación de escritura de área de reinicio asincrónica.When overridden in a derived class, begins an asynchronous restart area write operation.

Sobrecargas

BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

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

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

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

BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

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

public:
 IAsyncResult ^ BeginWriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginWriteRestartArea (ArraySegment<byte> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, System.IO.Log.ReservationCollection reservation, AsyncCallback callback, object state);
abstract member BeginWriteRestartArea : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
Public Function BeginWriteRestartArea (data As ArraySegment(Of Byte), newBaseSequenceNumber As SequenceNumber, reservation 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.

newBaseSequenceNumber
SequenceNumber

El nuevo número de secuencia base.The new base sequence number. El número de secuencia especificado debe ser mayor que o igual al número de secuencia base actual.The specified sequence number must be greater than or equal to the current base sequence number.

reservation
ReservationCollection

ReservationCollection que contiene la reserva que se debería utilizar para este área de reinicio.A ReservationCollection that contains the reservation that should be used for this restart area.

callback
AsyncCallback

Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado la escritura del área de reinicio.An optional asynchronous callback, to be called when the restart area write is complete.

state
Object

Objeto proporcionado por el usuario que distingue esta solicitud de área de reinicio asincrónica de otras.A user-provided object that distinguishes this particular asynchronous restart area write request from other requests.

Devoluciones

IAsyncResult

IAsyncResult que representa la operación de escritura de área de reinicio asincrónica, que todavía podría estar pendiente.An IAsyncResult that represents the asynchronous restart area write operation, which could still be pending.

Comentarios

Debería pasar IAsyncResult devuelto por este método al método EndWriteRestartArea para asegurarse de que la operación de escritura de área de reinicio ha finalizado y de que se pueden liberar los recursos apropiadamente.You should pass the IAsyncResult returned by this method to the EndWriteRestartArea method, to assure that the restart area write operation has completed and resources can be freed appropriately. Si se produce un error durante la escritura asincrónica, no se producirá una excepción hasta que se llame a EndWriteRestartArea con el IAsyncResult que devuelve este método.If an error has occurred during an asynchronous restart area write operation, an exception is not thrown until the EndWriteRestartArea 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.

Cuando la operación se completa correctamente, el número de secuencia base se actualiza.When the operation successfully completes, the base sequence number has been updated. Todas las entradas de registro con números de secuencia menores que el nuevo número de secuencia base son inaccesibles.All log records with sequence numbers less than the new base sequence number are inaccessible.

Si se especifica una ReservationCollection, el área de reinicio escrita utilizará el espacio que se ha reservado previamente, utilizando una reserva contenida en la colección.If a ReservationCollection is specified, the written restart area will consume space that has been previously reserved, using a reservation contained in the collection. Si el método tiene éxito, utilizará la reserva de menor tamaño que pueda contener los datos y esa reserva se quitará de la colección.If the method succeeds, it will consume the smallest reservation that can hold the data, and that reservation will be removed from the collection.

Si una secuencia del registro se ha eliminado, o si se pasa un argumento no válido, las excepciones se producen inmediatamente en esta operación.If a record sequence has been disposed of, or if you pass an invalid argument, exceptions are thrown immediately within this operation. Los errores que se produjeron durante una solicitud de anexado asincrónica, como, por ejemplo, un error de disco durante la petición de E/S, producirá excepciones que se producen cuando se llama al método EndWriteRestartArea.Errors that occurred during an asynchronous append request, for example, a disk failure during the I/O request, will result in exceptions being thrown when the EndWriteRestartArea method is called.

Se aplica a

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

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

public:
 IAsyncResult ^ BeginWriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginWriteRestartArea (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, System.IO.Log.ReservationCollection reservation, AsyncCallback callback, object state);
abstract member BeginWriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
Public Function BeginWriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSequenceNumber As SequenceNumber, reservation 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.

newBaseSequenceNumber
SequenceNumber

El nuevo número de secuencia base.The new base sequence number. El número de secuencia especificado debe ser mayor que o igual al número de secuencia base actual.The specified sequence number must be greater than or equal to the current base sequence number.

reservation
ReservationCollection

ReservationCollection que contiene la reserva que se debería utilizar para este área de reinicio.A ReservationCollection that contains the reservation that should be used for this restart area.

callback
AsyncCallback

Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado la escritura del área de reinicio.An optional asynchronous callback, to be called when the restart area write is complete.

state
Object

Objeto proporcionado por el usuario que distingue esta solicitud de área de reinicio asincrónica de otras.A user-provided object that distinguishes this particular asynchronous restart area write request from other requests.

Devoluciones

IAsyncResult

IAsyncResult que representa la operación de escritura de área de reinicio asincrónica, que todavía podría estar pendiente.An IAsyncResult that represents the asynchronous restart area write operation, which could still be pending.

Excepciones

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

Se produjo un error de E/S al escribir el área de reinicio.An I/O error occurred while writing the restart area.

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 EndWriteRestartArea para asegurarse que la operación de escritura de área de reinicio ha finalizado y que se pueden liberar los recursos apropiadamente.You should pass the IAsyncResult returned by this method to the EndWriteRestartArea method to ensure that the restart area write operation has completed and resources can be freed appropriately. Si se produce un error durante la escritura asincrónica, no se producirá una excepción hasta que se llame a EndWriteRestartArea con el IAsyncResult que devuelve este método.If an error has occurred during an asynchronous restart area write operation, an exception is not thrown until the EndWriteRestartArea 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.

Cuando la operación se completa correctamente, el número de secuencia base se actualiza.When the operation successfully completes, the base sequence number has been updated. Todas las entradas de registro con números de secuencia menores que el nuevo número de secuencia base son inaccesibles.All log records with sequence numbers less than the new base sequence number are inaccessible.

Si se especifica una ReservationCollection, el área de reinicio escrita utilizará el espacio que se ha reservado previamente, utilizando una reserva contenida en la colección.If a ReservationCollection is specified, the written restart area will consume space that has been previously reserved, using a reservation contained in the collection. Si el método tiene éxito, utilizará la reserva de menor tamaño que pueda contener los datos y esa reserva se quitará de la colección.If the method succeeds, it will consume the smallest reservation that can hold the data, and that reservation will be removed from the collection.

Si una secuencia del registro se ha eliminado, o si se pasa un argumento no válido, las excepciones se producen inmediatamente en esta operación.If a record sequence has been disposed of, or if you pass an invalid argument, exceptions are thrown immediately within this operation. Los errores que se produjeron durante una solicitud de anexado asincrónica, como, por ejemplo, un error de disco durante la petición de E/S, producirá excepciones que se producen cuando se llama al método EndWriteRestartArea.Errors that occurred during an asynchronous append request, for example, a disk failure during the I/O request, will result in exceptions being thrown when the EndWriteRestartArea method is called.

Se aplica a