IRecordSequence.Append Método
Definição
Quando substituída em uma classe derivada, grava um registro de log para o IRecordSequence.When overridden in a derived class, writes a log record to the IRecordSequence.
Sobrecargas
| Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions) |
Quando substituída em uma classe derivada, grava um registro de log para o IRecordSequence.When overridden in a derived class, writes a log record to the IRecordSequence. |
| Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions) |
Quando substituída em uma classe derivada, acrescenta um registro de log para o IRecordSequence.When overridden in a derived class, appends a log record to the IRecordSequence. |
| Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection) |
Quando substituída em uma classe derivada, acrescenta um registro de log no IRecordSequence, usando espaço reservado anteriormente na sequência.When overridden in a derived class, appends a log record to the IRecordSequence, using space previously reserved in the sequence. |
| Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection) |
Quando substituída em uma classe derivada, acrescenta um registro de log no IRecordSequence, usando espaço reservado anteriormente na sequência.When overridden in a derived class, appends a log record to the IRecordSequence, using space previously reserved in the sequence. |
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)
Quando substituída em uma classe derivada, grava um registro de log para o IRecordSequence.When overridden in a derived class, writes a log record to the 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.SequenceNumber
Public Function Append (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumber
Parâmetros
- data
- ArraySegment<Byte>
Uma lista de segmentos de matriz de bytes que serão concatenados e acrescentados como o registro.A list of byte array segments that will be concatenated and appended as the record.
- nextUndoRecord
- SequenceNumber
O número de sequência do próximo registro na ordem especificada pelo usuário.The sequence number of the next record in the user-specified order.
- previousRecord
- SequenceNumber
O número de sequência do próximo registro na ordem Anterior.The sequence number of the next record in Previous order.
- recordAppendOptions
- RecordAppendOptions
Um valor válido de RecordAppendOptions que especifica como os dados devem ser gravados.A valid value of RecordAppendOptions that specifies how the data should be written.
Retornos
O número de sequência do registro de log acrescentado.The sequence number of the appended log record.
Exceções
Um ou mais argumentos são inválidos.One or more of the arguments is invalid.
Um erro de E/S ocorreu ao acrescentar o registro.An I/O error occurred while appending the record.
A sequência de registro não pôde gerar espaço livre suficiente para conter o novo registro.The record sequence could not make enough free space to contain the new record.
O método foi chamado depois que a sequência foi descartada.The method was called after the sequence has been disposed of.
Comentários
Os dados contidos no data parâmetro serão concatenados em uma única matriz de bytes para anexar como o registro.Data contained in the data parameter will be concatenated into a single byte array for appending as the record. No entanto, nenhum provisionamento é feito para dividir os dados de volta em segmentos de matriz quando o registro é lido.However, no provision is made for splitting data back into array segments when the record is read.
Normalmente, esse método é concluído antes de o registro ser gravado.Normally, this method completes before the record has been written. Para garantir que um registro tenha sido gravado, especifique o ForceFlush sinalizador usando o recordAppendOptions parâmetro ou chame o Flush método.To ensure that a record has been written, either specify the ForceFlush flag using the recordAppendOptions parameter, or call the Flush method.
Aplica-se a
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)
Quando substituída em uma classe derivada, acrescenta um registro de log para o IRecordSequence.When overridden in a derived class, appends a log record to the 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.SequenceNumber
Public Function Append (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions) As SequenceNumber
Parâmetros
- data
- IList<ArraySegment<Byte>>
Uma lista de segmentos de matriz de bytes que serão concatenados e acrescentados como o registro.A list of byte array segments that will be concatenated and appended as the record.
- nextUndoRecord
- SequenceNumber
O número de sequência do próximo registro na ordem especificada pelo usuário.The sequence number of the next record in the user-specified order.
- previousRecord
- SequenceNumber
O número de sequência do próximo registro na ordem Anterior.The sequence number of the next record in Previous order.
- recordAppendOptions
- RecordAppendOptions
Um valor válido de RecordAppendOptions que especifica como os dados devem ser gravados.A valid value of RecordAppendOptions that specifies how the data should be written.
Retornos
O número de sequência do registro de log acrescentado.The sequence number of the appended log record.
Exceções
Um ou mais argumentos são inválidos.One or more of the arguments is invalid.
Um erro de E/S ocorreu ao acrescentar o registro.An I/O error occurred while appending the record.
A sequência de registro não pôde gerar espaço livre suficiente para conter o novo registro.The record sequence could not make enough free space to contain the new record.
O método foi chamado depois que a sequência foi descartada.The method was called after the sequence has been disposed of.
Comentários
Os dados contidos no data parâmetro serão concatenados em uma única matriz de bytes para anexar como o registro.Data contained in the data parameter will be concatenated into a single byte array for appending as the record. No entanto, nenhum provisionamento é feito para dividir os dados de volta em segmentos de matriz quando o registro é lido.However, no provision is made for splitting data back into array segments when the record is read.
Normalmente, esse método é concluído antes de o registro ser gravado.Normally, this method completes before the record has been written. Para garantir que um registro tenha sido gravado, especifique o ForceFlush sinalizador usando o recordAppendOptions parâmetro ou chame o Flush método.To ensure that a record has been written, either specify the ForceFlush flag using the recordAppendOptions parameter, or call the Flush method.
Aplica-se a
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)
Quando substituída em uma classe derivada, acrescenta um registro de log no IRecordSequence, usando espaço reservado anteriormente na sequência.When overridden in a derived class, appends a log record to the IRecordSequence, using space previously reserved in the sequence.
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.SequenceNumber
Public Function Append (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumber
Parâmetros
- data
- ArraySegment<Byte>
Uma lista de segmentos de matriz de bytes que serão concatenados e acrescentados como o registro.A list of byte array segments that will be concatenated and appended as the record.
- nextUndoRecord
- SequenceNumber
O número de sequência do próximo registro na ordem especificada pelo usuário.The sequence number of the next record in the user-specified order.
- previousRecord
- SequenceNumber
O número de sequência do próximo registro na ordem Anterior.The sequence number of the next record in Previous order.
- recordAppendOptions
- RecordAppendOptions
Um valor válido de RecordAppendOptions que especifica como os dados devem ser gravados.A valid value of RecordAppendOptions that specifies how the data should be written.
- reservations
- ReservationCollection
Um ReservationCollection que contém a reserva que deve ser usada para este registro.A ReservationCollection that contains the reservation that should be used for this record.
Retornos
O número de sequência do registro de log acrescentado.The sequence number of the appended log record.
Exceções
Um ou mais argumentos são inválidos.One or more of the arguments is invalid.
Um erro de E/S ocorreu ao acrescentar o registro.An I/O error occurred while appending the record.
A sequência de registro não pôde gerar espaço livre suficiente para conter o novo registro.The record sequence could not make enough free space to contain the new record.
O método foi chamado depois que a sequência foi descartada.The method was called after the sequence has been disposed of.
Comentários
Os dados contidos no data parâmetro serão concatenados em uma única matriz de bytes para anexar como o registro.Data contained in the data parameter will be concatenated into a single byte array for appending as the record. No entanto, nenhum provisionamento é feito para dividir os dados de volta em segmentos de matriz quando o registro é lido.However, no provision is made for splitting data back into array segments when the record is read.
O registro anexado consumirá o espaço que foi reservado anteriormente, usando uma reserva especificada pelo reservations parâmetro.The appended record will consume space that has been previously reserved, using a reservation specified by the reservations parameter. Se o acréscimo for bem sucedido, ele consumirá a menor área de reserva que pode conter os dados e essa área de reserva será removida da coleção.If the append succeeds, it will consume the smallest reservation area that can hold the data, and that reservation area will be removed from the collection.
Normalmente, esse método é concluído antes de o registro ser gravado.Normally, this method completes before the record has been written. Para garantir que um registro tenha sido gravado, especifique o ForceFlush sinalizador usando o recordAppendOptions parâmetro ou chame o Flush método.To ensure that a record has been written, either specify the ForceFlush flag using the recordAppendOptions parameter, or call the Flush method.
Aplica-se a
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)
Quando substituída em uma classe derivada, acrescenta um registro de log no IRecordSequence, usando espaço reservado anteriormente na sequência.When overridden in a derived class, appends a log record to the IRecordSequence, using space previously reserved in the sequence.
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.SequenceNumber
Public Function Append (data As IList(Of ArraySegment(Of Byte)), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservations As ReservationCollection) As SequenceNumber
Parâmetros
- data
- IList<ArraySegment<Byte>>
Uma lista de segmentos de matriz de bytes que serão concatenados e acrescentados como o registro.A list of byte array segments that will be concatenated and appended as the record.
- nextUndoRecord
- SequenceNumber
O número de sequência do próximo registro na ordem especificada pelo usuário.The sequence number of the next record in the user-specified order.
- previousRecord
- SequenceNumber
O número de sequência do próximo registro na ordem Anterior.The sequence number of the next record in Previous order.
- recordAppendOptions
- RecordAppendOptions
Um valor válido de RecordAppendOptions que especifica como os dados devem ser gravados.A valid value of RecordAppendOptions that specifies how the data should be written.
- reservations
- ReservationCollection
Um ReservationCollection que contém a reserva que deve ser usada para este registro.A ReservationCollection that contains the reservation that should be used for this record.
Retornos
O número de sequência do registro de log acrescentado.The sequence number of the appended log record.
Exceções
Um ou mais argumentos são inválidos.One or more of the arguments is invalid.
Um erro de E/S ocorreu ao acrescentar o registro.An I/O error occurred while appending the record.
A sequência de registro não pôde gerar espaço livre suficiente para conter o novo registro.The record sequence could not make enough free space to contain the new record.
O método foi chamado depois que a sequência foi descartada.The method was called after the sequence has been disposed of.
Comentários
Os dados contidos no data parâmetro serão concatenados em uma única matriz de bytes para anexar como o registro.Data contained in the data parameter will be concatenated into a single byte array for appending as the record. No entanto, nenhum provisionamento é feito para dividir os dados de volta em segmentos de matriz quando o registro é lido.However, no provision is made for splitting data back into array segments when the record is read.
O registro anexado consumirá o espaço que foi reservado anteriormente, usando uma reserva especificada pelo reservations parâmetro.The appended record will consume space that has been previously reserved, using a reservation specified by the reservations parameter. Se o acréscimo for bem sucedido, ele consumirá a menor área de reserva que pode conter os dados e essa área de reserva será removida da coleção.If the append succeeds, it will consume the smallest reservation area that can hold the data, and that reservation area will be removed from the collection.
Normalmente, esse método é concluído antes de o registro ser gravado.Normally, this method completes before the record has been written. Para garantir que um registro tenha sido gravado, especifique o ForceFlush sinalizador usando o recordAppendOptions parâmetro ou chame o Flush método.To ensure that a record has been written, either specify the ForceFlush flag using the recordAppendOptions parameter, or call the Flush method.