LogRecordSequence.ReserveAndAppend Metoda

  • Reference

Definice

Obor názvů:
System.IO.Log
Sestavení:
System.IO.Log.dll

Automaticky vytvoří jednu rezervaci a připojí k sekvenci záznam.

Přetížení

ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

Automaticky vytvoří jednu rezervaci a připojí k sekvenci záznam. Tuto metodu nelze dědit.
ReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

Automaticky vytvoří jednu rezervaci a připojí k sekvenci záznam. Tuto metodu nelze dědit.

ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

Automaticky vytvoří jednu rezervaci a připojí k sekvenci záznam. Tuto metodu nelze dědit.

public:
 virtual System::IO::Log::SequenceNumber ReserveAndAppend(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber userRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservationCollection, ... cli::array <long> ^ reservations);
public System.IO.Log.SequenceNumber ReserveAndAppend (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber userRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservationCollection, params long[] reservations);
abstract member ReserveAndAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] -> System.IO.Log.SequenceNumber
override this.ReserveAndAppend : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] -> System.IO.Log.SequenceNumber
Public Function ReserveAndAppend (data As IList(Of ArraySegment(Of Byte)), userRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, ParamArray reservations As Long()) As SequenceNumber

Parametry

data
IList<ArraySegment<Byte>>

Seznam segmentů pole bajtů, které budou zřetězeny a připojeny jako záznam.

userRecord
SequenceNumber

Pořadové číslo dalšího záznamu v pořadí zadaném uživatelem.

previousRecord
SequenceNumber

Pořadové číslo dalšího záznamu v předchozím pořadí.

recordAppendOptions
RecordAppendOptions

Platná hodnota určuje RecordAppendOptions , jak se mají data zapsat.

reservationCollection
ReservationCollection

Kolekce rezervací, ve které se mají provádět rezervace.

reservations
Int64[]

Rezervace, které se mají provést, v bajtech.

Návraty

SequenceNumber

Pořadové číslo připojeného záznamu protokolu.

Implementuje

ReserveAndAppend(IList<ArraySegment<Byte>>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

Výjimky

ArgumentException

Jeden nebo více argumentů je neplatných.

IOException

Při připojování záznamu došlo k vstupně-výstupní chybě.

SequenceFullException

V sekvenci záznamů se nepodařilo vytvořit dostatek volného místa pro nový záznam nebo pro vytvoření rezervace.

ObjectDisposedException

Metoda byla volána po odstranění sekvence.

ArgumentNullException

Jeden nebo více argumentů je null.

ArgumentOutOfRangeException

userRecord nebo previousRecord není mezi základním a posledním pořadovými čísly této sekvence.

NotSupportedException

Operaci nelze provést, protože sekvence záznamů byla otevřena s přístupem jen pro čtení.

OutOfMemoryException

Pro pokračování v provádění programu není dostatek paměti.

UnauthorizedAccessException

Operační systém odepře přístup k zadané sekvenci protokolu.

ReservationNotFoundException

Na webu se nenachází reservationsžádná rezervace dostatečně velká, aby se vešladata.

Poznámky

Data obsažená v parametru data budou zřetězena do jednoho bajtového pole pro připojení jako záznam. Při čtení záznamu však není provedeno žádné ustanovení pro rozdělení dat zpět do segmentů pole.

Zadané rezervace se přidají do zadané kolekce rezervací v atomické operaci pomocí operace připojení záznamu. Pokud se připojení nezdaří, nevyhradí se žádné místo.

Za normálních okolností se tato metoda může dokončit před zápisem záznamu. Pokud chcete zajistit, aby byl záznam zapsán, zadejte ForceFlush příznak pomocí parametru recordAppendOptions nebo volejte metodu Flush .

Platí pro

ReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

Automaticky vytvoří jednu rezervaci a připojí k sekvenci záznam. Tuto metodu nelze dědit.

public:
 virtual System::IO::Log::SequenceNumber ReserveAndAppend(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber nextUndoRecord, System::IO::Log::SequenceNumber previousRecord, System::IO::Log::RecordAppendOptions recordAppendOptions, System::IO::Log::ReservationCollection ^ reservationCollection, ... cli::array <long> ^ reservations);
public System.IO.Log.SequenceNumber ReserveAndAppend (ArraySegment<byte> data, System.IO.Log.SequenceNumber nextUndoRecord, System.IO.Log.SequenceNumber previousRecord, System.IO.Log.RecordAppendOptions recordAppendOptions, System.IO.Log.ReservationCollection reservationCollection, params long[] reservations);
abstract member ReserveAndAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] -> System.IO.Log.SequenceNumber
override this.ReserveAndAppend : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.SequenceNumber * System.IO.Log.RecordAppendOptions * System.IO.Log.ReservationCollection * int64[] -> System.IO.Log.SequenceNumber
Public Function ReserveAndAppend (data As ArraySegment(Of Byte), nextUndoRecord As SequenceNumber, previousRecord As SequenceNumber, recordAppendOptions As RecordAppendOptions, reservationCollection As ReservationCollection, ParamArray reservations As Long()) As SequenceNumber

Parametry

data
ArraySegment<Byte>

Seznam segmentů pole bajtů, které budou zřetězeny a připojeny jako záznam.

nextUndoRecord
SequenceNumber

Pořadové číslo dalšího záznamu v pořadí zadaném uživatelem.

previousRecord
SequenceNumber

Pořadové číslo dalšího záznamu v předchozím pořadí.

recordAppendOptions
RecordAppendOptions

Platná hodnota určuje RecordAppendOptions , jak se mají data zapsat.

reservationCollection
ReservationCollection

A ReservationCollection obsahující kolekci, ve které se mají provádět rezervace.

reservations
Int64[]

Rezervace, které se mají provést, v bajtech.

Návraty

SequenceNumber

Pořadové číslo připojeného záznamu protokolu.

Implementuje

ReserveAndAppend(ArraySegment<Byte>, SequenceNumber, SequenceNumber, RecordAppendOptions, ReservationCollection, Int64[])

Výjimky

ArgumentException

nextUndoRecord nebo previousRecord není pro tuto sekvenci platná.

-nebo-

data nelze připojit, protože je větší než maximální velikost záznamu.

-nebo-

reservations nebyla vytvořena touto sekvencí záznamů.

ArgumentNullException

Jeden nebo více argumentů je null.

ArgumentOutOfRangeException

nextUndoRecord nebo previousRecord není mezi základním a posledním pořadovými čísly této sekvence.

IOException

Požadavek nebylo možné provést kvůli neočekávané výjimce vstupně-výstupních operací.

-nebo-

Požadavek nelze provést kvůli chybě vstupně-výstupního zařízení.

NotSupportedException

Operaci nelze provést, protože sekvence záznamů byla otevřena s přístupem jen pro čtení.

ObjectDisposedException

Metoda byla volána po odstranění sekvence.

OutOfMemoryException

Pro pokračování v provádění programu není dostatek paměti.

SequenceFullException

Posloupnost záznamů je plná.

UnauthorizedAccessException

Operační systém odepře přístup k zadané sekvenci protokolu.

ReservationNotFoundException

Na webu se nenachází reservationsžádná rezervace dostatečně velká, aby se vešladata.

Příklady

Následující příklad ukazuje, jak tuto metodu použít k provádění rezervací. Všimněte si, že tuto úlohu lze provést pouze při použití třídy založené na LogRecordSequence clfs.

ReservationCollection reservations = recordSequence.CreateReservationCollection();  
long[] lengthOfUndoRecords = new long[] { 1000 };  
recordSequence.ReserveAndAppend(recordData,  
                                                     userSqn,  
                                                     previousSqn,  
                                                     RecordSequenceAppendOptions.None,  
                                                     reservations,  
                                                     lengthOfUndoRecords);  
recordSequence.Append(undoRecordData,    // If necessary …  
                                    userSqn,  
                                    previousSqn,  
                                    RecordSequenceAppendOptions.ForceFlush,  
                                    reservations);

Poznámky

Data obsažená v parametru data budou zřetězena do jednoho bajtového pole pro připojení jako záznam. Při čtení záznamu však není provedeno žádné ustanovení pro rozdělení dat zpět do segmentů pole.

Zadané rezervace se přidají do zadané kolekce rezervací v atomické operaci pomocí operace připojení záznamu. Pokud se připojení nezdaří, nevyhradí se žádné místo.

Za normálních okolností se tato metoda může dokončit před zápisem záznamu. Pokud chcete zajistit, aby byl záznam zapsán, zadejte ForceFlush příznak pomocí parametru recordAppendOptions nebo volejte metodu Flush .

Platí pro