FileRecordSequence.BeginWriteRestartArea Metoda

Definice

Obor názvů:

System.IO.Log

Sestavení:

System.IO.Log.dll

Zahájí asynchronní operaci zápisu do oblasti restartování.

Přetížení

Name	Description
BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)	Zahájí asynchronní operaci zápisu do oblasti restartování pomocí místa, které bylo dříve vyhrazeno v sekvenci. Tuto metodu nelze zdědit.
BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)	Zahájí asynchronní operaci zápisu do oblasti restartování pomocí místa, které bylo dříve vyhrazeno v sekvenci. Tuto metodu nelze zdědit.

BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Zahájí asynchronní operaci zápisu do oblasti restartování pomocí místa, které bylo dříve vyhrazeno v sekvenci. Tuto metodu nelze zdědit.

public:
 virtual IAsyncResult ^ BeginWriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSeqNum, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginWriteRestartArea(ArraySegment<byte> data, System.IO.Log.SequenceNumber newBaseSeqNum, System.IO.Log.ReservationCollection reservation, AsyncCallback callback, object state);

abstract member BeginWriteRestartArea : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
override this.BeginWriteRestartArea : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult

Public Function BeginWriteRestartArea (data As ArraySegment(Of Byte), newBaseSeqNum As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult

Parametry

data

ArraySegment<Byte>

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

newBaseSeqNum

SequenceNumber

Nové základní pořadové číslo. Zadané pořadové číslo musí být větší nebo rovno aktuálnímu základnímu pořadové číslu.

reservation

ReservationCollection

A ReservationCollection obsahující rezervaci, která by se měla použít pro tuto oblast restartování.

callback

AsyncCallback

Volitelné asynchronní zpětné volání, které se má volat při dokončení zápisu do oblasti restartování.

state

Object

Objekt poskytovaný uživatelem, který rozlišuje tento konkrétní asynchronní požadavek na zápis oblasti restartování od jiných požadavků.

Návraty

IAsyncResult

Jedná se o IAsyncResult asynchronní operaci zápisu do oblasti restartování, která může být stále čekající.

Implementuje

BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Výjimky

ArgumentNullException

Jeden nebo více argumentů jsou null.

ArgumentOutOfRangeException

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

nebo

Nový nebo existující archivní chvost nebo základ aktivního protokolu je neplatný.

ArgumentException

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

nebo

newBaseSeqNum není pro tuto sekvenci platný.

NotSupportedException

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

IOException

Požadavek nelze provést kvůli neočekávané výjimce vstupně-výstupní operace.

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á.

ReservationNotFoundException

Rezervace není dostatečně velká, aby se vešla data do reservationsumístění .

Poznámky

Tuto metodu IAsyncResult byste měli předat EndWriteRestartArea vrácené touto metodou, abyste zajistili, že operace zápisu do oblasti restartování byla dokončena a prostředky lze odpovídajícím způsobem uvolnit. Pokud během operace zápisu do oblasti asynchronního restartování došlo k chybě, není vyvolána výjimka, dokud EndWriteRestartArea metoda nebude volána s IAsyncResult vrácenou touto metodou.

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

Po úspěšném dokončení operace se základní pořadové číslo aktualizovalo. Všechny záznamy protokolu s pořadovými čísly menšími než nové základní pořadové číslo jsou nepřístupné.

ReservationCollection Pokud je zadaný, zapisovaná oblast restartování spotřebuje místo, které bylo dříve rezervováno, pomocí rezervace obsažené v kolekci. Pokud bude metoda úspěšná, spotřebuje nejmenší rezervaci, která může uchovávat data, a tato rezervace se z kolekce odebere.

Pokud je posloupnost záznamů uvolněna nebo pokud předáte neplatný argument, výjimky se v rámci této operace vyvolá okamžitě. Chyby, ke kterým došlo během asynchronního žádosti o připojení, například selhání disku během V/V požadavku, způsobí vyvolání výjimek při EndWriteRestartArea zavolání metody.

BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Zahájí asynchronní operaci zápisu do oblasti restartování pomocí místa, které bylo dříve vyhrazeno v sekvenci. Tuto metodu nelze zdědit.

public:
 virtual IAsyncResult ^ BeginWriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber newBaseSeqNum, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginWriteRestartArea(System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber newBaseSeqNum, System.IO.Log.ReservationCollection reservation, AsyncCallback callback, object state);

abstract member BeginWriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult
override this.BeginWriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection * AsyncCallback * obj -> IAsyncResult

Public Function BeginWriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSeqNum As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult

Parametry

data

IList<ArraySegment<Byte>>

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

newBaseSeqNum

SequenceNumber

Nové základní pořadové číslo. Zadané pořadové číslo musí být větší nebo rovno aktuálnímu základnímu pořadové číslu.

reservation

ReservationCollection

A ReservationCollection obsahující rezervaci, která by se měla použít pro tuto oblast restartování.

callback

AsyncCallback

Volitelné asynchronní zpětné volání, které se má volat při dokončení zápisu do oblasti restartování.

state

Object

Objekt poskytovaný uživatelem, který rozlišuje tento konkrétní asynchronní požadavek na zápis oblasti restartování od jiných požadavků.

Návraty

IAsyncResult

Jedná se o IAsyncResult asynchronní operaci zápisu do oblasti restartování, která může být stále čekající.

Implementuje

BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)

Výjimky

ArgumentNullException

Jeden nebo více argumentů jsou null.

ArgumentOutOfRangeException

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

nebo

Nový nebo existující archivní chvost nebo základ aktivního protokolu je neplatný.

ArgumentException

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

nebo

newBaseSeqNum není pro tuto sekvenci platný.

NotSupportedException

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

IOException

Požadavek nelze provést kvůli neočekávané výjimce vstupně-výstupní operace.

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á.

ReservationNotFoundException

Rezervace není dostatečně velká, aby se vešla data do reservationsumístění .

Poznámky

Tuto metodu IAsyncResult byste měli předat EndWriteRestartArea vrácené touto metodou, abyste zajistili, že operace zápisu do oblasti restartování byla dokončena a prostředky lze odpovídajícím způsobem uvolnit. Pokud během operace zápisu do oblasti asynchronního restartování došlo k chybě, není vyvolána výjimka, dokud EndWriteRestartArea metoda nebude volána s IAsyncResult vrácenou touto metodou.

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

Po úspěšném dokončení operace se základní pořadové číslo aktualizovalo. Všechny záznamy protokolu s pořadovými čísly menšími než nové základní pořadové číslo jsou nepřístupné.

ReservationCollection Pokud je zadaný, zapisovaná oblast restartování spotřebuje místo, které bylo dříve rezervováno, pomocí rezervace obsažené v kolekci. Pokud bude metoda úspěšná, spotřebuje nejmenší rezervaci, která může uchovávat data, a tato rezervace se z kolekce odebere.

Pokud je posloupnost záznamů uvolněna nebo pokud předáte neplatný argument, výjimky se v rámci této operace vyvolá okamžitě. Chyby, ke kterým došlo během asynchronního žádosti o připojení, například selhání disku během V/V požadavku, způsobí vyvolání výjimek při EndWriteRestartArea zavolání metody.