IRecordSequence.BeginWriteRestartArea Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se reemplaza en una clase derivada, comienza una operación de escritura de área de reinicio asincrónica.
Sobrecargas
| Nombre | Description |
|---|---|
| BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object) |
Cuando se reemplaza en una clase derivada, comienza una operación de escritura de área de reinicio asincrónica, utilizando el espacio reservado previamente en la secuencia. |
| BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object) |
Cuando se reemplaza en una clase derivada, comienza una operación de escritura de área de reinicio asincrónica, utilizando el espacio reservado previamente en la secuencia. |
BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)
Cuando se reemplaza en una clase derivada, comienza una operación de escritura de área de reinicio asincrónica, utilizando el espacio reservado previamente en la secuencia.
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 -> IAsyncResultPublic Function BeginWriteRestartArea (data As ArraySegment(Of Byte), newBaseSequenceNumber As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResultParámetros
- data
- ArraySegment<Byte>
Lista de segmentos de matriz de bytes que se concatenarán y anexarán como registro.
- newBaseSequenceNumber
- SequenceNumber
Nuevo número de secuencia base. El número de secuencia especificado debe ser mayor o igual que el número de secuencia base actual.
- reservation
- ReservationCollection
que ReservationCollection contiene la reserva que se debe usar para este área de reinicio.
- callback
- AsyncCallback
Se llamará a una devolución de llamada asincrónica opcional cuando se complete la escritura del área de reinicio.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de escritura de área de reinicio asincrónica determinada de otras solicitudes.
Devoluciones
que IAsyncResult representa la operación de escritura del área de reinicio asincrónica, que todavía podría estar pendiente.
Comentarios
Debe pasar el IAsyncResult devuelto por este método al EndWriteRestartArea método , para asegurarse de que la operación de escritura del área de reinicio se ha completado y los recursos se pueden liberar adecuadamente. Si se ha producido un error durante una operación de escritura de área de reinicio asincrónica, no se produce una excepción hasta que se llama al EndWriteRestartArea método con el IAsyncResult devuelto por este método.
Los datos contenidos en el data parámetro se concatenan en una sola matriz de bytes para anexarse como registro. Sin embargo, no se realiza ninguna disposición para dividir los datos en segmentos de matriz cuando se lee el registro.
Cuando la operación se completa correctamente, se ha actualizado el número de secuencia base. No se puede acceder a todos los registros con números de secuencia inferiores al nuevo número de secuencia base.
Si se especifica un ReservationCollection , el área de reinicio escrito consumirá espacio que se ha reservado previamente, mediante una reserva contenida en la colección. Si el método se realiza correctamente, consumirá la reserva más pequeña que puede contener los datos y esa reserva se quitará de la colección.
Si se ha eliminado una secuencia de registros o si se pasa un argumento no válido, las excepciones se inician inmediatamente dentro de esta operación. Los errores que se produjeron durante una solicitud de anexión asincrónica, por ejemplo, un error de disco durante la solicitud de E/S, darán lugar a excepciones que se producen cuando se llama al EndWriteRestartArea método .
Se aplica a
BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)
Cuando se reemplaza en una clase derivada, comienza una operación de escritura de área de reinicio asincrónica, utilizando el espacio reservado previamente en la secuencia.
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 -> IAsyncResultPublic Function BeginWriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSequenceNumber As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResultParámetros
- data
- IList<ArraySegment<Byte>>
Lista de segmentos de matriz de bytes que se concatenarán y anexarán como registro.
- newBaseSequenceNumber
- SequenceNumber
Nuevo número de secuencia base. El número de secuencia especificado debe ser mayor o igual que el número de secuencia base actual.
- reservation
- ReservationCollection
que ReservationCollection contiene la reserva que se debe usar para este área de reinicio.
- callback
- AsyncCallback
Se llamará a una devolución de llamada asincrónica opcional cuando se complete la escritura del área de reinicio.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de escritura de área de reinicio asincrónica determinada de otras solicitudes.
Devoluciones
que IAsyncResult representa la operación de escritura del área de reinicio asincrónica, que todavía podría estar pendiente.
Excepciones
Uno o varios argumentos no son válidos.
Error de E/S al escribir el área de reinicio.
La secuencia de registros no pudo hacer suficiente espacio libre para contener el nuevo registro.
Se llamó al método después de eliminar la secuencia.
Comentarios
Debe pasar el IAsyncResult devuelto por este método al EndWriteRestartArea método para asegurarse de que la operación de escritura del área de reinicio se ha completado y los recursos se pueden liberar correctamente. Si se ha producido un error durante una operación de escritura de área de reinicio asincrónica, no se produce una excepción hasta que se llama al EndWriteRestartArea método con el IAsyncResult devuelto por este método.
Los datos contenidos en el data parámetro se concatenan en una sola matriz de bytes para anexarse como registro. Sin embargo, no se realiza ninguna disposición para dividir los datos en segmentos de matriz cuando se lee el registro.
Cuando la operación se completa correctamente, se ha actualizado el número de secuencia base. No se puede acceder a todos los registros con números de secuencia inferiores al nuevo número de secuencia base.
Si se especifica un ReservationCollection , el área de reinicio escrito consumirá espacio que se ha reservado previamente, mediante una reserva contenida en la colección. Si el método se realiza correctamente, consumirá la reserva más pequeña que puede contener los datos y esa reserva se quitará de la colección.
Si se ha eliminado una secuencia de registros o si se pasa un argumento no válido, las excepciones se inician inmediatamente dentro de esta operación. Los errores que se produjeron durante una solicitud de anexión asincrónica, por ejemplo, un error de disco durante la solicitud de E/S, darán lugar a excepciones que se producen cuando se llama al EndWriteRestartArea método .
