FileRecordSequence.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í.
Inicia una operación de anexión asincrónica.
Sobrecargas
| Nombre | Description |
|---|---|
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
Inicia una operación de anexión asincrónica mediante el espacio previamente reservado en la secuencia. Este método no se puede heredar. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object) |
Inicia una operación de anexión asincrónica mediante el espacio previamente reservado en la secuencia. Este método no se puede heredar. |
| BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
Inicia una operación de anexión asincrónica. Este método no se puede heredar. |
| BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object) |
Inicia una operación de anexión asincrónica. Este método no se puede heredar. |
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
Inicia una operación de anexión asincrónica mediante el espacio previamente reservado en la secuencia. Este método no se puede heredar.
public:
virtual 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, 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 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)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations 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.
- nextUndoRecord
- SequenceNumber
Número de secuencia del siguiente registro en el orden especificado por el usuario.
- previousRecord
- SequenceNumber
Número de secuencia del siguiente registro en orden anterior.
- recordAppendOptions
- RecordAppendOptions
Valor válido de RecordAppendOptions que especifica cómo se deben escribir los datos.
- reservations
- ReservationCollection
que ReservationCollection contiene la reserva que se debe usar para este registro.
- callback
- AsyncCallback
Se llamará a una devolución de llamada asincrónica opcional cuando se complete la anexión.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de anexión asincrónica determinada de otras solicitudes.
Devoluciones
que IAsyncResult representa la anexión asincrónica, que todavía podría estar pendiente.
Implementaciones
Excepciones
Uno o varios de los argumentos son null.
Uno o varios de los argumentos están fuera del intervalo.
reservations esta secuencia de registros no la creó.
No se puede realizar la operación porque la secuencia de registros se abrió con acceso de solo lectura.
No se puede realizar la solicitud debido a una excepción de E/S inesperada.
Se llamó al método después de eliminar la secuencia.
No hay memoria suficiente para continuar con la ejecución del programa.
La secuencia de registros está llena.
No se puede encontrar ninguna reserva lo suficientemente grande como para caber data en reservations.
Comentarios
Debe pasar el IAsyncResult devuelto por este método al EndAppend método para asegurarse de que la operación de anexión se haya completado y que los recursos se puedan liberar correctamente. Si se ha producido un error durante una anexión asincrónica, no se produce una excepción hasta que se llama al EndAppend 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.
El registro anexado consumirá espacio que se ha reservado previamente mediante una reserva especificada por el reservations parámetro . Si la anexión se realiza correctamente, consumirá el área de reserva más pequeña que puede contener los datos y ese á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 ForceFlush marca mediante el recordAppendOptions parámetro o llame al Flush método .
Se aplica a
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)
Inicia una operación de anexión asincrónica mediante el espacio previamente reservado en la secuencia. 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>
Lista de segmentos de matriz de bytes que se concatenarán y anexarán como registro.
- nextUndoRecord
- SequenceNumber
Número de secuencia del siguiente registro en el orden especificado por el usuario.
- previousRecord
- SequenceNumber
Número de secuencia del siguiente registro en orden anterior.
- recordAppendOptions
- RecordAppendOptions
Valor válido de RecordAppendOptions que especifica cómo se deben escribir los datos.
- reservations
- ReservationCollection
que ReservationCollection contiene la reserva que se debe usar para este registro.
- callback
- AsyncCallback
Se llamará a una devolución de llamada asincrónica opcional cuando se complete la anexión.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de anexión asincrónica determinada de otras solicitudes.
Devoluciones
que IAsyncResult representa la anexión asincrónica, que todavía podría estar pendiente.
Implementaciones
Excepciones
Uno o varios de los argumentos son null.
Uno o varios de los argumentos están fuera del intervalo.
reservations esta secuencia de registros no la creó.
No se puede realizar la operación porque la secuencia de registros se abrió con acceso de solo lectura.
No se puede realizar la solicitud debido a una excepción de E/S inesperada.
Se llamó al método después de eliminar la secuencia.
No hay memoria suficiente para continuar con la ejecución del programa.
La secuencia de registros está llena.
No se puede encontrar ninguna reserva lo suficientemente grande como para caber data en reservations.
Comentarios
Debe pasar el IAsyncResult devuelto por este método al EndAppend método para asegurarse de que la operación de anexión se haya completado y que los recursos se puedan liberar correctamente. Si se ha producido un error durante una anexión asincrónica, no se produce una excepción hasta que se llama al EndAppend 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.
El registro anexado consumirá espacio que se ha reservado previamente mediante una reserva especificada por el reservations parámetro . Si la anexión se realiza correctamente, consumirá el área de reserva más pequeña que puede contener los datos y ese á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 ForceFlush marca mediante el recordAppendOptions parámetro o llame al Flush método .
Se aplica a
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
Inicia una operación de anexión 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>
Lista de segmentos de matriz de bytes que se concatenarán y anexarán como registro.
- nextUndoRecord
- SequenceNumber
Número de secuencia del siguiente registro en el orden especificado por el usuario.
- previousRecord
- SequenceNumber
Número de secuencia del siguiente registro en orden anterior.
- recordAppendOptions
- RecordAppendOptions
Valor válido de RecordAppendOptions que especifica cómo se deben escribir los datos.
- callback
- AsyncCallback
Se llamará a una devolución de llamada asincrónica opcional cuando se complete la anexión.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de anexión asincrónica determinada de otras solicitudes.
Devoluciones
que IAsyncResult representa la anexión asincrónica, que todavía podría estar pendiente.
Implementaciones
Excepciones
Uno o varios de los argumentos son null.
Uno o varios de los argumentos están fuera del intervalo.
No se puede realizar la operación porque la secuencia de registros se abrió con acceso de solo lectura.
No se puede realizar la solicitud debido a una excepción de E/S inesperada.
Se llamó al método después de eliminar la secuencia.
No hay memoria suficiente para continuar con la ejecución del programa.
La secuencia de registros está llena.
Comentarios
Debe pasar el IAsyncResult devuelto por este método al EndAppend método para asegurarse de que la operación de anexión se haya completado y que los recursos se puedan liberar correctamente. Si se ha producido un error durante una anexión asincrónica, no se produce una excepción hasta que se llama al EndAppend 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.
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 ForceFlush marca mediante el recordAppendOptions parámetro o llame al Flush método .
Se aplica a
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)
Inicia una operación de anexión 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 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
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)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, 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.
- nextUndoRecord
- SequenceNumber
Número de secuencia del siguiente registro en el orden especificado por el usuario.
- previousRecord
- SequenceNumber
Número de secuencia del siguiente registro en orden anterior.
- recordAppendOptions
- RecordAppendOptions
Valor válido de RecordAppendOptions que especifica cómo se deben escribir los datos.
- callback
- AsyncCallback
Se llamará a una devolución de llamada asincrónica opcional cuando se complete la anexión.
- state
- Object
Objeto proporcionado por el usuario que distingue esta solicitud de anexión asincrónica determinada de otras solicitudes.
Devoluciones
que IAsyncResult representa la anexión asincrónica, que todavía podría estar pendiente.
Implementaciones
Excepciones
Uno o varios de los argumentos son null.
Uno o varios de los argumentos están fuera del intervalo.
No se puede realizar la operación porque la secuencia de registros se abrió con acceso de solo lectura.
No se puede realizar la solicitud debido a una excepción de E/S inesperada.
Se llamó al método después de eliminar la secuencia.
No hay memoria suficiente para continuar con la ejecución del programa.
La secuencia de registros está llena.
Comentarios
Debe pasar el IAsyncResult devuelto por este método al EndAppend método para asegurarse de que la operación de anexión se haya completado y que los recursos se puedan liberar correctamente. Si se ha producido un error durante una anexión asincrónica, no se produce una excepción hasta que se llama al EndAppend 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.
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 ForceFlush marca mediante el recordAppendOptions parámetro o llame al Flush método .