IRecordSequence Rozhraní

Definice

Obor názvů:

System.IO.Log

Sestavení:

System.IO.Log.dll

Poskytuje obecné rozhraní pro posloupnost záznamů.

public interface class IRecordSequence : IDisposable

public interface IRecordSequence : IDisposable

type IRecordSequence = interface
    interface IDisposable

Public Interface IRecordSequence
Implements IDisposable

Odvozené

System.IO.Log.FileRecordSequence

System.IO.Log.LogRecordSequence

Implementuje

IDisposable

Poznámky

Rozhraní IRecordSequence poskytuje abstraktní rozhraní pro datový proud orientovaný na záznamy. Instanci IRecordSequence lze použít ke čtení a zápisu záznamů protokolu.

Rozhraní IRecordSequence poskytuje následující funkce:

• Připojte záznamy protokolu pomocí Append metod.

• Pomocí metody načtěte připojené záznamy ReadLogRecords .

• Zapište speciální záznam restartování pomocí WriteRestartArea metody .

• Pomocí metody načtěte záznamy restartování z naposledy zapsaného záznamu ReadRestartAreas restartování.

• Pomocí metody vyprázdněte záznamy do trvalého úložiště Flush .

• Vyhraďte místo pro připojení záznamů.

• Uvolněte místo v protokolu tím, že posunete základ protokolu.

• Příjem TailPinned oznámení o událostech pro přesunutí základu protokolu do volného místa

Záznamy protokolu se připojí k IRecordSequence instanci a každému záznamu protokolu se přidělí jedinečné pořadové číslo. Pořadová čísla se v dané sekvenci záznamů výhradně monotónně zvyšují. Záznam protokolu se skládá z neprůsažných dat, která se do IRecordSequence instance zadává v IList souboru ArraySegments bajtů.

Rozhraní IRecordSequence také zveřejňuje několik základních vlastností, které poskytují informace o hranicích protokolu.

• Vlastnost BaseSequenceNumber obsahuje pořadové číslo prvního platného záznamu v posloupnosti záznamů.

• Vlastnost LastSequenceNumber obsahuje pořadové číslo, které je zaručeno, že bude větší než pořadové číslo posledního připojeného záznamu.

• Vlastnost RestartSequenceNumber obsahuje pořadové číslo poslední zapsané oblasti restartování.

• Vlastnost MaximumRecordLength obsahuje velikost největšího záznamu, který lze připojit nebo číst ze sekvence.

• Vlastnost ReservedBytes obsahuje celkovou velikost všech rezervací provedených v této posloupnosti záznamů.

• RetryAppend Pokud je vlastnost nastavena na truea Append operace selže, protože v sekvenci není žádné místo, sekvence záznamů se pokusí uvolnit místo a zkusí operaci připojit znovu.

Vlastnosti

BaseSequenceNumber	Při přepsání v odvozené třídě získá pořadové číslo prvního platného záznamu v aktuální IRecordSequence.
LastSequenceNumber	Při přepsání v odvozené třídě získá pořadové číslo, které je větší než poslední připojený záznam.
MaximumRecordLength	Při přepsání v odvozené třídě získá velikost největšího záznamu, který lze připojit nebo číst z této sekvence v bajtech.
ReservedBytes	Při přepsání v odvozené třídě získá celkový počet bajtů, které byly rezervovány.
RestartSequenceNumber	Při přepsání v odvozené třídě získá pořadové číslo naposledy zapsané oblasti restartování.
RetryAppend	Získá nebo nastaví hodnotu označující, zda se připojení automaticky opakovat, pokud je protokol plný.

Metody

AdvanceBaseSequenceNumber(SequenceNumber)	Přesune základní pořadové číslo protokolu vpřed.
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Při přepsání v odvozené třídě zapíše záznam protokolu do IRecordSequence.
Append(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	Při přepsání v odvozené třídě připojí záznam protokolu k IRecordSequence, pomocí mezery dříve rezervované v sekvenci.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions)	Při přepsání v odvozené třídě připojí záznam protokolu k objektu IRecordSequence.
Append(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection)	Při přepsání v odvozené třídě připojí záznam protokolu k IRecordSequence, pomocí mezery dříve rezervované v sekvenci.
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)	Při přepsání v odvozené třídě zahájí asynchronní operaci připojení.
BeginAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)	Při přepsání v odvozené třídě zahájí asynchronní operaci připojení pomocí mezery dříve rezervované v sekvenci.
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, AsyncCallback, Object)	Při přepsání v odvozené třídě zahájí asynchronní operaci připojení pomocí mezery dříve rezervované v sekvenci.
BeginAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, AsyncCallback, Object)	Při přepsání v odvozené třídě zahájí asynchronní operaci připojení pomocí mezery dříve rezervované v sekvenci.
BeginFlush(SequenceNumber, AsyncCallback, Object)	Při přepsání v odvozené třídě, zahájí asynchronní vyprázdnění operace s využitím místa dříve vyhrazeného v sekvenci.
BeginReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)	Při přepsání v odvozené třídě zahájí asynchronní operaci rezervace a připojení.
BeginReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[], AsyncCallback, Object)	Při přepsání v odvozené třídě zahájí asynchronní operaci rezervace a připojení.
BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)	Při přepsání v odvozené třídě zahájí asynchronní operaci zápisu do oblasti restartování s využitím místa dříve rezervovaného v sekvenci.
BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)	Při přepsání v odvozené třídě zahájí asynchronní operaci zápisu do oblasti restartování s využitím místa dříve rezervovaného v sekvenci.
CreateReservationCollection()	Při přepsání v odvozené třídě vytvoří novou ReservationCollection.
Dispose()	Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od IDisposable)
EndAppend(IAsyncResult)	Při přepsání v odvozené třídě ukončí asynchronní operaci připojení.
EndFlush(IAsyncResult)	Při přepsání v odvozené třídě ukončí asynchronní vyprázdnění operaci.
EndReserveAndAppend(IAsyncResult)	Při přepsání v odvozené třídě končí asynchronní operace rezervace a připojení.
EndWriteRestartArea(IAsyncResult)	Při přepsání v odvozené třídě ukončí asynchronní operaci zápisu oblasti restartování.
Flush()	Při přepsání v odvozené třídě zajišťuje, že všechny připojené záznamy byly zapsány.
Flush(SequenceNumber)	Při přepsání v odvozené třídě zajišťuje, že všechny připojené záznamy až do a včetně záznamu se zadaným pořadovým číslem byly trvale zapsány.
ReadLogRecords(SequenceNumber, LogRecordEnumeratorType)	Při přepsání v odvozené třídě vrátí výčtovou kolekci záznamů v sekvenci.
ReadRestartAreas()	Při přepsání v odvozené třídě vrátí výčtovou kolekci oblastí restartování v sekvenci.
ReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])	Při přepsání v odvozené třídě automaticky vytvoří jednu rezervaci a připojí záznam k sekvenci.
ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])	Při přepsání v odvozené třídě automaticky vytvoří jednu rezervaci a připojí záznam k sekvenci.
WriteRestartArea(ArraySegment<Byte>)	Při přepsání v odvozené třídě zapíše oblast restartování do IRecordSequence.
WriteRestartArea(ArraySegment<Byte>, SequenceNumber)	Při přepsání v odvozené třídě zapíše oblast restartování do IRecordSequence a aktualizuje základní pořadové číslo.
WriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection)	Při přepsání v odvozené třídě zapíše oblast restartování do IRecordSequence rezervace a aktualizuje základní pořadové číslo.
WriteRestartArea(IList<ArraySegment<Byte>>)	Při přepsání v odvozené třídě zapíše oblast restartování do IRecordSequence.
WriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber)	Při přepsání v odvozené třídě zapíše oblast restartování do IRecordSequence a aktualizuje základní pořadové číslo.
WriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection)	Při přepsání v odvozené třídě zapíše oblast restartování do IRecordSequence rezervace a aktualizuje základní pořadové číslo.

Událost

TailPinned

Nastane, když sekvence záznamů určí, že chvost musí být posunut dopředu.