IRecordSequence.Append 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 invalida en una clase derivada, escribe una entrada de registro en IRecordSequence.
Sobrecargas
| Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions) |
Cuando se invalida en una clase derivada, escribe una entrada de registro en IRecordSequence. |
| Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions) |
Cuando se invalida en una clase derivada, anexa una entrada de registro en IRecordSequence. |
| Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection) |
Cuando se invalida en una clase derivada, anexa una entrada de registro a IRecordSequence, utilizando el espacio previamente reservado en la secuencia. |
| Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection) |
Cuando se invalida en una clase derivada, anexa una entrada de registro a IRecordSequence, utilizando el espacio previamente reservado en la secuencia. |
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)
Cuando se invalida en una clase derivada, escribe una entrada de registro en IRecordSequence.
public:
System::IO::Log::SequenceNumber Append(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions);public System.IO.Log.SequenceNumber Append (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions);abstract member Append : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions -> System.IO.Log.SequenceNumberPublic Function Append (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumberPará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.
Devoluciones
Número de secuencia del registro de entrada anexado.
Excepciones
Uno o varios argumentos no son válidos.
Ha ocurrido un error de E/S al anexar un registro.
La secuencia del registro no pudo liberar espacio suficiente para contener el nuevo registro.
Se llamó al método una vez eliminada la secuencia.
Comentarios
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
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)
Cuando se invalida en una clase derivada, anexa una entrada de registro en IRecordSequence.
public:
System::IO::Log::SequenceNumber Append(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions);public System.IO.Log.SequenceNumber Append (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions);abstract member Append : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions -> System.IO.Log.SequenceNumberPublic Function Append (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumberParámetros
- data
- IList<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.
Devoluciones
Número de secuencia del registro de entrada anexado.
Excepciones
Uno o varios argumentos no son válidos.
Ha ocurrido un error de E/S al anexar un registro.
La secuencia del registro no pudo liberar espacio suficiente para contener el nuevo registro.
Se llamó al método una vez eliminada la secuencia.
Comentarios
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
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)
Cuando se invalida en una clase derivada, anexa una entrada de registro a IRecordSequence, utilizando el espacio previamente reservado en la secuencia.
public:
System::IO::Log::SequenceNumber Append(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservations);public System.IO.Log.SequenceNumber Append (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservations);abstract member Append : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumberPublic Function Append (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumberPará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.
Devoluciones
Número de secuencia del registro de entrada anexado.
Excepciones
Uno o varios argumentos no son válidos.
Ha ocurrido un error de E/S al anexar un registro.
La secuencia del registro no pudo liberar espacio suficiente para contener el nuevo registro.
Se llamó al método una vez eliminada la secuencia.
Comentarios
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
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)
Cuando se invalida en una clase derivada, anexa una entrada de registro a IRecordSequence, utilizando el espacio previamente reservado en la secuencia.
public:
System::IO::Log::SequenceNumber Append(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);public System.IO.Log.SequenceNumber Append (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);abstract member Append : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumberPublic Function Append (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumberParámetros
- data
- IList<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.
Devoluciones
Número de secuencia del registro de entrada anexado.
Excepciones
Uno o varios argumentos no son válidos.
Ha ocurrido un error de E/S al anexar un registro.
La secuencia del registro no pudo liberar espacio suficiente para contener el nuevo registro.
Se llamó al método una vez eliminada la secuencia.
Comentarios
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 GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de