IRecordSequence.Append Método

Definição

Namespace:

System.IO.Log

Assembly:

System.IO.Log.dll

Quando substituída em uma classe derivada, grava um registro de log para o IRecordSequence.

Sobrecargas

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Quando substituída em uma classe derivada, grava um registro de log para o IRecordSequence.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Quando substituída em uma classe derivada, acrescenta um registro de log para o 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.
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.

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)

Quando substituída em uma classe derivada, grava um registro de log para o 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.

nextUndoRecord

SequenceNumber

O número de sequência do próximo registro na ordem especificada pelo usuário.

previousRecord

SequenceNumber

O número de sequência do próximo registro na ordem Anterior.

recordAppendOptions

RecordAppendOptions

Um valor válido de RecordAppendOptions que especifica como os dados devem ser gravados.

Retornos

SequenceNumber

O número de sequência do registro de log acrescentado.

Exceções

ArgumentException

Um ou mais argumentos são inválidos.

IOException

Um erro de E/S ocorreu ao acrescentar o registro.

SequenceFullException

A sequência de registro não pôde gerar espaço livre suficiente para conter o novo registro.

ObjectDisposedException

O método foi chamado depois que a sequência foi descartada.

Comentários

Os dados contidos no data parâmetro serão concatenados em uma única matriz de bytes para acrescentar como o registro. No entanto, nenhuma provisão é feita para dividir dados novamente em segmentos de matriz quando o registro é lido.

Normalmente, esse método é concluído antes da gravação do registro. Para garantir que um registro tenha sido gravado, especifique o ForceFlush sinalizador usando o recordAppendOptions parâmetro ou chame o Flush método .

Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)

Quando substituída em uma classe derivada, acrescenta um registro de log para o 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.

nextUndoRecord

SequenceNumber

O número de sequência do próximo registro na ordem especificada pelo usuário.

previousRecord

SequenceNumber

O número de sequência do próximo registro na ordem Anterior.

recordAppendOptions

RecordAppendOptions

Um valor válido de RecordAppendOptions que especifica como os dados devem ser gravados.

Retornos

SequenceNumber

O número de sequência do registro de log acrescentado.

Exceções

ArgumentException

Um ou mais argumentos são inválidos.

IOException

Um erro de E/S ocorreu ao acrescentar o registro.

SequenceFullException

A sequência de registro não pôde gerar espaço livre suficiente para conter o novo registro.

ObjectDisposedException

O método foi chamado depois que a sequência foi descartada.

Comentários

Os dados contidos no data parâmetro serão concatenados em uma única matriz de bytes para acrescentar como o registro. No entanto, nenhuma provisão é feita para dividir dados novamente em segmentos de matriz quando o registro é lido.

Normalmente, esse método é concluído antes da gravação do registro. Para garantir que um registro tenha sido gravado, especifique o ForceFlush sinalizador usando o recordAppendOptions parâmetro ou chame o Flush método .

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.

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.

nextUndoRecord

SequenceNumber

O número de sequência do próximo registro na ordem especificada pelo usuário.

previousRecord

SequenceNumber

O número de sequência do próximo registro na ordem Anterior.

recordAppendOptions

RecordAppendOptions

Um valor válido de RecordAppendOptions que especifica como os dados devem ser gravados.

reservations

ReservationCollection

Um ReservationCollection que contém a reserva que deve ser usada para este registro.

Retornos

SequenceNumber

O número de sequência do registro de log acrescentado.

Exceções

ArgumentException

Um ou mais argumentos são inválidos.

IOException

Um erro de E/S ocorreu ao acrescentar o registro.

SequenceFullException

A sequência de registro não pôde gerar espaço livre suficiente para conter o novo registro.

ObjectDisposedException

O método foi chamado depois que a sequência foi descartada.

Comentários

Os dados contidos no data parâmetro serão concatenados em uma única matriz de bytes para acrescentar como o registro. No entanto, nenhuma provisão é feita para dividir dados novamente em segmentos de matriz quando o registro é lido.

O registro acrescentado consumirá o espaço que foi reservado anteriormente, usando uma reserva especificada pelo reservations parâmetro . 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.

Normalmente, esse método é concluído antes da gravação do registro. Para garantir que um registro tenha sido gravado, especifique o ForceFlush sinalizador usando o recordAppendOptions parâmetro ou chame o Flush método .

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.

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.

nextUndoRecord

SequenceNumber

O número de sequência do próximo registro na ordem especificada pelo usuário.

previousRecord

SequenceNumber

O número de sequência do próximo registro na ordem Anterior.

recordAppendOptions

RecordAppendOptions

Um valor válido de RecordAppendOptions que especifica como os dados devem ser gravados.

reservations

ReservationCollection

Um ReservationCollection que contém a reserva que deve ser usada para este registro.

Retornos

SequenceNumber

O número de sequência do registro de log acrescentado.

Exceções

ArgumentException

Um ou mais argumentos são inválidos.

IOException

Um erro de E/S ocorreu ao acrescentar o registro.

SequenceFullException

A sequência de registro não pôde gerar espaço livre suficiente para conter o novo registro.

ObjectDisposedException

O método foi chamado depois que a sequência foi descartada.

Comentários

Os dados contidos no data parâmetro serão concatenados em uma única matriz de bytes para acrescentar como o registro. No entanto, nenhuma provisão é feita para dividir dados novamente em segmentos de matriz quando o registro é lido.

O registro acrescentado consumirá o espaço que foi reservado anteriormente, usando uma reserva especificada pelo reservations parâmetro . 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.

Normalmente, esse método é concluído antes da gravação do registro. Para garantir que um registro tenha sido gravado, especifique o ForceFlush sinalizador usando o recordAppendOptions parâmetro ou chame o Flush método .