IRecordSequence.Append Metoda

Definicja

Przestrzeń nazw:

System.IO.Log

Zestaw:

System.IO.Log.dll

Po przesłonięciu w klasie pochodnej zapisuje rekord dziennika w obiekcie IRecordSequence.

Przeciążenia

Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Po przesłonięciu w klasie pochodnej zapisuje rekord dziennika w obiekcie IRecordSequence.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Po zastąpieniu w klasie pochodnej dołącza rekord dziennika do klasy IRecordSequence.
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	Po zastąpieniu w klasie pochodnej dołącza rekord dziennika do IRecordSequenceklasy , używając spacji wcześniej zarezerwowanej w sekwencji.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	Po zastąpieniu w klasie pochodnej dołącza rekord dziennika do IRecordSequenceklasy , używając spacji wcześniej zarezerwowanej w sekwencji.

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

Po przesłonięciu w klasie pochodnej zapisuje rekord dziennika w obiekcie 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

Parametry

data

ArraySegment<Byte>

Lista segmentów tablic bajtowych, które będą łączone i dołączane jako rekord.

nextUndoRecord

SequenceNumber

Numer sekwencji następnego rekordu w określonej przez użytkownika kolejności.

previousRecord

SequenceNumber

Numer sekwencji następnego rekordu w poprzedniej kolejności.

recordAppendOptions

RecordAppendOptions

Prawidłowa wartość określa sposób zapisywania RecordAppendOptions danych.

Zwraca

SequenceNumber

Numer sekwencji dołączonego rekordu dziennika.

Wyjątki

ArgumentException

Co najmniej jeden argument jest nieprawidłowy.

IOException

Wystąpił błąd we/wy podczas dołączania rekordu.

SequenceFullException

Sekwencja rekordów nie może zwolnić wolnego miejsca, aby zawierać nowy rekord.

ObjectDisposedException

Metoda została wywołana po usunięciu sekwencji.

Uwagi

Dane zawarte w parametrze data zostaną łączone w jedną tablicę bajtów na potrzeby dołączania jako rekordu. Jednak podczas odczytywania rekordu nie jest wprowadzana żadna aprowizacja dzielenia danych z powrotem na segmenty tablic.

Zwykle ta metoda kończy się przed zapisaniem rekordu. Aby upewnić się, że rekord został zapisany, określ flagę ForceFlush przy użyciu parametru recordAppendOptions lub wywołaj metodę Flush .

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

Po zastąpieniu w klasie pochodnej dołącza rekord dziennika do klasy 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

Parametry

data

IList<ArraySegment<Byte>>

Lista segmentów tablic bajtowych, które będą łączone i dołączane jako rekord.

nextUndoRecord

SequenceNumber

Numer sekwencji następnego rekordu w określonej przez użytkownika kolejności.

previousRecord

SequenceNumber

Numer sekwencji następnego rekordu w poprzedniej kolejności.

recordAppendOptions

RecordAppendOptions

Prawidłowa wartość określa sposób zapisywania RecordAppendOptions danych.

Zwraca

SequenceNumber

Numer sekwencji dołączonego rekordu dziennika.

Wyjątki

ArgumentException

Co najmniej jeden argument jest nieprawidłowy.

IOException

Wystąpił błąd we/wy podczas dołączania rekordu.

SequenceFullException

Sekwencja rekordów nie może zwolnić wolnego miejsca, aby zawierać nowy rekord.

ObjectDisposedException

Metoda została wywołana po usunięciu sekwencji.

Uwagi

Dane zawarte w parametrze data zostaną łączone w jedną tablicę bajtów na potrzeby dołączania jako rekordu. Jednak podczas odczytywania rekordu nie jest wprowadzana żadna aprowizacja dzielenia danych z powrotem na segmenty tablic.

Zwykle ta metoda kończy się przed zapisaniem rekordu. Aby upewnić się, że rekord został zapisany, określ flagę ForceFlush przy użyciu parametru recordAppendOptions lub wywołaj metodę Flush .

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

Po zastąpieniu w klasie pochodnej dołącza rekord dziennika do IRecordSequenceklasy , używając spacji wcześniej zarezerwowanej w sekwencji.

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

Parametry

data

ArraySegment<Byte>

Lista segmentów tablic bajtowych, które będą łączone i dołączane jako rekord.

nextUndoRecord

SequenceNumber

Numer sekwencji następnego rekordu w określonej przez użytkownika kolejności.

previousRecord

SequenceNumber

Numer sekwencji następnego rekordu w poprzedniej kolejności.

recordAppendOptions

RecordAppendOptions

Prawidłowa wartość określa sposób zapisywania RecordAppendOptions danych.

reservations

ReservationCollection

Obiekt ReservationCollection zawierający rezerwację, która powinna być używana dla tego rekordu.

Zwraca

SequenceNumber

Numer sekwencji dołączonego rekordu dziennika.

Wyjątki

ArgumentException

Co najmniej jeden argument jest nieprawidłowy.

IOException

Wystąpił błąd we/wy podczas dołączania rekordu.

SequenceFullException

Sekwencja rekordów nie może zwolnić wolnego miejsca, aby zawierać nowy rekord.

ObjectDisposedException

Metoda została wywołana po usunięciu sekwencji.

Uwagi

Dane zawarte w parametrze data zostaną łączone w jedną tablicę bajtów na potrzeby dołączania jako rekordu. Jednak podczas odczytywania rekordu nie jest wprowadzana żadna aprowizacja dzielenia danych z powrotem na segmenty tablic.

Dołączony rekord będzie zużywać miejsce, które zostało wcześniej zarezerwowane, przy użyciu rezerwacji określonej przez reservations parametr . Jeśli dołączanie zakończy się pomyślnie, będzie korzystać z najmniejszego obszaru rezerwacji, który może przechowywać dane, a ten obszar rezerwacji zostanie usunięty z kolekcji.

Zwykle ta metoda kończy się przed zapisaniem rekordu. Aby upewnić się, że rekord został zapisany, określ flagę ForceFlush przy użyciu parametru recordAppendOptions lub wywołaj metodę Flush .

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

Po zastąpieniu w klasie pochodnej dołącza rekord dziennika do IRecordSequenceklasy , używając spacji wcześniej zarezerwowanej w sekwencji.

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

Parametry

data

IList<ArraySegment<Byte>>

Lista segmentów tablic bajtowych, które będą łączone i dołączane jako rekord.

nextUndoRecord

SequenceNumber

Numer sekwencji następnego rekordu w określonej przez użytkownika kolejności.

previousRecord

SequenceNumber

Numer sekwencji następnego rekordu w poprzedniej kolejności.

recordAppendOptions

RecordAppendOptions

Prawidłowa wartość określa sposób zapisywania RecordAppendOptions danych.

reservations

ReservationCollection

Obiekt ReservationCollection zawierający rezerwację, która powinna być używana dla tego rekordu.

Zwraca

SequenceNumber

Numer sekwencji dołączonego rekordu dziennika.

Wyjątki

ArgumentException

Co najmniej jeden argument jest nieprawidłowy.

IOException

Wystąpił błąd we/wy podczas dołączania rekordu.

SequenceFullException

Sekwencja rekordów nie może zwolnić wolnego miejsca, aby zawierać nowy rekord.

ObjectDisposedException

Metoda została wywołana po usunięciu sekwencji.

Uwagi

Dane zawarte w parametrze data zostaną łączone w jedną tablicę bajtów na potrzeby dołączania jako rekordu. Jednak podczas odczytywania rekordu nie jest wprowadzana żadna aprowizacja dzielenia danych z powrotem na segmenty tablic.

Dołączony rekord będzie zużywać miejsce, które zostało wcześniej zarezerwowane, przy użyciu rezerwacji określonej przez reservations parametr . Jeśli dołączanie zakończy się pomyślnie, będzie korzystać z najmniejszego obszaru rezerwacji, który może przechowywać dane, a ten obszar rezerwacji zostanie usunięty z kolekcji.

Zwykle ta metoda kończy się przed zapisaniem rekordu. Aby upewnić się, że rekord został zapisany, określ flagę ForceFlush przy użyciu parametru recordAppendOptions lub wywołaj metodę Flush .