LogRecordSequence.BeginAppend 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í.
Comienza una operación de anexado asincrónica.
Sobrecargas
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
Comienza una operación de anexado asincrónica. Este método no se puede heredar. |
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
Comienza una operación de anexado asincrónica. Este método no se puede heredar. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
Comienza una operación de anexado asincrónica. Este método no se puede heredar. |
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
Comienza una operación de anexado asincrónica. Este método no se puede heredar. |
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
Comienza una operación de anexado asincrónica. Este método no se puede heredar.
public:
virtual 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
override this.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 IAsyncResultParámetros
- data
- ArraySegment<Byte>
Una lista de segmentos de la matriz de bytes que se concatenarán y anexarán como el registro.
- nextUndoRecord
- SequenceNumber
El número de secuencia del registro siguiente en el orden especificado por el usuario.
- previousRecord
- SequenceNumber
El número de secuencia del registro siguiente en orden anterior.
- recordAppendOptions
- RecordAppendOptions
Un valor válido de RecordAppendOptions que especifica cómo se deberían escribir los datos.
- callback
- AsyncCallback
Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado el anexado.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de anexado asincrónica de otras.
Devoluciones
Objeto IAsyncResult que representa el anexado asincrónico, que puede hallarse aún pendiente.
Implementaciones
Excepciones
nextUndoRecord o previousRecord no es válido para esta secuencia.
o bien
No se pueden anexar data porque es mayor que el tamaño de registro máximo.
o bien
Esta secuencia del registro no creó reservations.
Uno o varios argumentos tienen el valor null.
El valor de nextUndoRecord o de previousRecord no está entre los números de secuencia base y último de esta secuencia.
La solicitud no se pudo realizar debido a una excepción de E/S inesperada.
o bien
La solicitud no se pudo realizar debido a un error de dispositivo de E/S.
La operación no se puede realizar porque la secuencia del registro se abrió con acceso de solo lectura.
Se llamó al método una vez eliminada la secuencia.
No hay bastante memoria para continuar la ejecución del programa.
La secuencia del registro está completa.
El sistema operativo ha denegado el acceso a la secuencia de registro especificado.
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. 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.
Los datos contenidos en el parámetro data se concatenarán en una matriz de bytes única para anexarlos como el registro. 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.
Normalmente, este método se completa antes de que se haya escrito el registro. Para asegurarse de que se ha escrito un registro, especifique la marca ForceFlush utilizando el parámetro recordAppendOptions o llame al método Flush.
Se aplica a
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
Comienza una operación de anexado asincrónica. Este método no se puede heredar.
public:
virtual IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber userRecord, 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 userRecord, 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
override this.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)), userRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, callback As AsyncCallback, state As Object) As IAsyncResultParámetros
- data
- IList<ArraySegment<Byte>>
Una lista de segmentos de la matriz de bytes que se concatenarán y anexarán como el registro.
- userRecord
- SequenceNumber
El número de secuencia del registro siguiente en el orden especificado por el usuario.
- previousRecord
- SequenceNumber
El número de secuencia del registro siguiente en orden anterior.
- recordAppendOptions
- RecordAppendOptions
Un valor válido de RecordAppendOptions que especifica cómo se deberían escribir los datos.
- callback
- AsyncCallback
Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado el anexado.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de anexado asincrónica de otras.
Devoluciones
Objeto IAsyncResult que representa el anexado asincrónico, que puede hallarse aún pendiente.
Implementaciones
Excepciones
userRecord o previousRecord no es válido para esta secuencia.
o bien
No se pueden anexar data porque es mayor que el tamaño de registro máximo.
o bien
Esta secuencia del registro no creó reservations.
Uno o varios argumentos tienen el valor null.
El valor de userRecord o de previousRecord no está entre los números de secuencia base y último de esta secuencia.
La solicitud no se pudo realizar debido a una excepción de E/S inesperada.
o bien
La solicitud no se pudo realizar debido a un error de dispositivo de E/S.
La operación no se puede realizar porque la secuencia del registro se abrió con acceso de solo lectura.
Se llamó al método una vez eliminada la secuencia.
No hay bastante memoria para continuar la ejecución del programa.
La secuencia del registro está completa.
El sistema operativo ha denegado el acceso a la secuencia de registro especificado.
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. 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.
Los datos contenidos en el parámetro data se concatenarán en una matriz de bytes única para anexarlos como el registro. 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.
Normalmente, este método se completa antes de que se haya escrito el registro. Para asegurarse de que se ha escrito un registro, especifique la marca ForceFlush utilizando el parámetro recordAppendOptions o llame al método Flush.
Se aplica a
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
Comienza una operación de anexado asincrónica. Este método no se puede heredar.
public:
virtual 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
override this.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 IAsyncResultParámetros
- data
- ArraySegment<Byte>
Una lista de segmentos de la matriz de bytes que se concatenarán y anexarán como el registro.
- nextUndoRecord
- SequenceNumber
El número de secuencia del registro siguiente en el orden especificado por el usuario.
- previousRecord
- SequenceNumber
El número de secuencia del registro siguiente en orden anterior.
- recordAppendOptions
- RecordAppendOptions
Un valor válido de RecordAppendOptions que especifica cómo se deberían escribir los datos.
- reservations
- ReservationCollection
Una ReservationCollection que contiene la reserva que se debería utilizar para este registro.
- callback
- AsyncCallback
Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado el anexado.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de anexado asincrónica de otras.
Devoluciones
Objeto IAsyncResult que representa el anexado asincrónico, que puede hallarse aún pendiente.
Implementaciones
Excepciones
userRecord o previousRecord no es válido para esta secuencia.
o bien
No se pueden anexar data porque es mayor que el tamaño de registro máximo.
o bien
Esta secuencia del registro no creó reservations.
Uno o varios argumentos tienen el valor null.
El valor de userRecord o de previousRecord no está entre los números de secuencia base y último de esta secuencia.
La solicitud no se pudo realizar debido a una excepción de E/S inesperada.
o bien
La solicitud no se pudo realizar debido a un error de dispositivo de E/S.
La operación no se puede realizar porque la secuencia del registro se abrió con acceso de solo lectura.
Se llamó al método una vez eliminada la secuencia.
No hay bastante memoria para continuar la ejecución del programa.
La secuencia del registro está completa.
El sistema operativo ha denegado el acceso a la secuencia de registro especificado.
No se puede encontrar en data ninguna reserva lo suficientemente grande para ajustar reservations.
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. 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.
Los datos contenidos en el parámetro data se concatenarán en una matriz de bytes única para anexarlos como el registro. 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.
El registro anexado utilizará el espacio que se ha reservado previamente, utilizando una reserva especificada por el parámetro reservations. 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.
Normalmente, este método se completa antes de que se haya escrito el registro. Para asegurarse de que se ha escrito un registro, especifique la marca ForceFlush utilizando el parámetro recordAppendOptions o llame al método Flush.
Se aplica a
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
Comienza una operación de anexado asincrónica. Este método no se puede heredar.
public:
virtual IAsyncResult ^ BeginAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber userRecord, System::IO::Log::SequenceNumber previousRecord, 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 userRecord, System.IO.Log.SequenceNumber previousRecord, 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
override this.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)), userRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResultParámetros
- data
- IList<ArraySegment<Byte>>
Una lista de segmentos de la matriz de bytes que se concatenarán y anexarán como el registro.
- userRecord
- SequenceNumber
El número de secuencia del registro siguiente en el orden especificado por el usuario.
- previousRecord
- SequenceNumber
El número de secuencia del registro siguiente en orden anterior.
- recordAppendOptions
- RecordAppendOptions
Un valor válido de RecordAppendOptions que especifica cómo se deberían escribir los datos.
- reservations
- ReservationCollection
Una ReservationCollection que contiene la reserva que se debería utilizar para este registro.
- callback
- AsyncCallback
Devolución de llamada asincrónica opcional, a la que se llamará cuando haya finalizado el anexado.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de anexado asincrónica de otras.
Devoluciones
Objeto IAsyncResult que representa el anexado asincrónico, que puede hallarse aún pendiente.
Implementaciones
Excepciones
userRecord o previousRecord no es válido para esta secuencia.
o bien
No se pueden anexar data porque es mayor que el tamaño de registro máximo.
o bien
Esta secuencia del registro no creó reservations.
Uno o varios argumentos tienen el valor null.
El valor de userRecord o de previousRecord no está entre los números de secuencia base y último de esta secuencia.
La solicitud no se pudo realizar debido a una excepción de E/S inesperada.
o bien
La solicitud no se pudo realizar debido a un error de dispositivo de E/S.
La operación no se puede realizar porque la secuencia del registro se abrió con acceso de solo lectura.
Se llamó al método una vez eliminada la secuencia.
No hay bastante memoria para continuar la ejecución del programa.
La secuencia del registro está completa.
El sistema operativo ha denegado el acceso a la secuencia de registro especificado.
No se puede encontrar en data ninguna reserva lo suficientemente grande para ajustar reservations.
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. 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.
Los datos contenidos en el parámetro data se concatenarán en una matriz de bytes única para anexarlos como el registro. 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.
El registro anexado utilizará el espacio que se ha reservado previamente, utilizando una reserva especificada por el parámetro reservations. 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.
Normalmente, este método se completa antes de que se haya escrito el registro. Para asegurarse de que se ha escrito un registro, especifique la marca ForceFlush utilizando el parámetro recordAppendOptions o llame al método Flush.
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de