IRecordSequence.BeginWriteRestartArea Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Po zastąpieniu w klasie pochodnej rozpoczyna asynchroniczną operację zapisu obszaru ponownego uruchamiania.
Przeciążenia
| Nazwa | Opis |
|---|---|
| BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object) |
Po zastąpieniu w klasie pochodnej rozpoczyna asynchroniczną operację zapisu obszaru ponownego uruchamiania, używając spacji zarezerwowanej wcześniej w sekwencji. |
| BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object) |
Po zastąpieniu w klasie pochodnej rozpoczyna asynchroniczną operację zapisu obszaru ponownego uruchamiania, używając spacji zarezerwowanej wcześniej w sekwencji. |
BeginWriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection, AsyncCallback, Object)
Po zastąpieniu w klasie pochodnej rozpoczyna asynchroniczną operację zapisu obszaru ponownego uruchamiania, używając spacji zarezerwowanej wcześniej w sekwencji.
public:
IAsyncResult ^ BeginWriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginWriteRestartArea(ArraySegment<byte> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, 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
Public Function BeginWriteRestartArea (data As ArraySegment(Of Byte), newBaseSequenceNumber As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult
Parametry
- data
- ArraySegment<Byte>
Lista segmentów tablic bajtowych, które będą łączone i dołączane jako rekord.
- newBaseSequenceNumber
- SequenceNumber
Nowy numer sekwencji bazowej. Określony numer sekwencji musi być większy lub równy bieżącemu numerowi sekwencji bazowej.
- reservation
- ReservationCollection
Element ReservationCollection zawierający rezerwację, która powinna być używana dla tego obszaru ponownego uruchamiania.
- callback
- AsyncCallback
Opcjonalne wywołanie zwrotne asynchroniczne, które ma być wywoływane po zakończeniu zapisu obszaru ponownego uruchamiania.
- state
- Object
Obiekt dostarczony przez użytkownika, który rozróżnia ten konkretny asynchroniczny obszar ponownego uruchamiania żądania zapisu z innych żądań.
Zwraca
Element IAsyncResult reprezentujący asynchroniczną operację zapisu obszaru ponownego uruchamiania, która nadal może być oczekująca.
Uwagi
Należy przekazać zwrócony IAsyncResult przez tę metodę metodę EndWriteRestartArea , aby upewnić się, że operacja zapisu obszaru ponownego uruchomienia została ukończona, a zasoby mogą być odpowiednio zwolnione. Jeśli wystąpił błąd podczas asynchronicznej operacji zapisu obszaru ponownego uruchamiania, wyjątek nie jest zgłaszany, dopóki EndWriteRestartArea metoda nie zostanie wywołana przy IAsyncResult użyciu metody zwróconej przez tę metodę.
Dane zawarte w parametrze data będą łączone w jedną tablicę bajtów do dołączania jako rekordu. Jednak podczas odczytu rekordu nie jest wprowadzana żadna aprowizacja dzielenia danych z powrotem na segmenty tablicy.
Po pomyślnym zakończeniu operacji numer sekwencji podstawowej został zaktualizowany. Wszystkie rekordy dziennika z numerami sekwencji mniejsze niż nowy numer sekwencji podstawowej są niedostępne.
ReservationCollection Jeśli zostanie określony, zapisany obszar ponownego uruchamiania będzie zużywać miejsce, które zostało wcześniej zarezerwowane, przy użyciu rezerwacji zawartej w kolekcji. Jeśli metoda powiedzie się, będzie korzystać z najmniejszej rezerwacji, która może przechowywać dane, i że rezerwacja zostanie usunięta z kolekcji.
Jeśli sekwencja rekordów została usunięta lub jeśli przekazano nieprawidłowy argument, wyjątki są zgłaszane natychmiast w ramach tej operacji. Błędy, które wystąpiły podczas asynchronicznego żądania dołączania, na przykład błąd dysku podczas żądania we/wy, spowodują zgłoszenie wyjątków podczas wywoływanej EndWriteRestartArea metody.
Dotyczy
BeginWriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection, AsyncCallback, Object)
Po zastąpieniu w klasie pochodnej rozpoczyna asynchroniczną operację zapisu obszaru ponownego uruchamiania, używając spacji zarezerwowanej wcześniej w sekwencji.
public:
IAsyncResult ^ BeginWriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginWriteRestartArea(System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, 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
Public Function BeginWriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSequenceNumber As SequenceNumber, reservation As ReservationCollection, callback As AsyncCallback, state As Object) As IAsyncResult
Parametry
- data
- IList<ArraySegment<Byte>>
Lista segmentów tablic bajtowych, które będą łączone i dołączane jako rekord.
- newBaseSequenceNumber
- SequenceNumber
Nowy numer sekwencji bazowej. Określony numer sekwencji musi być większy lub równy bieżącemu numerowi sekwencji bazowej.
- reservation
- ReservationCollection
Element ReservationCollection zawierający rezerwację, która powinna być używana dla tego obszaru ponownego uruchamiania.
- callback
- AsyncCallback
Opcjonalne wywołanie zwrotne asynchroniczne, które ma być wywoływane po zakończeniu zapisu obszaru ponownego uruchamiania.
- state
- Object
Obiekt dostarczony przez użytkownika, który rozróżnia ten konkretny asynchroniczny obszar ponownego uruchamiania żądania zapisu z innych żądań.
Zwraca
Element IAsyncResult reprezentujący asynchroniczną operację zapisu obszaru ponownego uruchamiania, która nadal może być oczekująca.
Wyjątki
Co najmniej jeden argument jest nieprawidłowy.
Wystąpił błąd we/wy podczas zapisywania obszaru ponownego uruchamiania.
Sekwencja rekordów nie może zwolnić wolnego miejsca, aby zawierać nowy rekord.
Metoda została wywołana po usunięciu sekwencji.
Uwagi
Należy przekazać zwróconą IAsyncResult przez tę metodę metodę do EndWriteRestartArea metody, aby upewnić się, że operacja zapisu obszaru ponownego uruchomienia została ukończona, a zasoby można odpowiednio zwolnić. Jeśli wystąpił błąd podczas asynchronicznej operacji zapisu obszaru ponownego uruchamiania, wyjątek nie jest zgłaszany, dopóki EndWriteRestartArea metoda nie zostanie wywołana przy IAsyncResult użyciu metody zwróconej przez tę metodę.
Dane zawarte w parametrze data będą łączone w jedną tablicę bajtów do dołączania jako rekordu. Jednak podczas odczytu rekordu nie jest wprowadzana żadna aprowizacja dzielenia danych z powrotem na segmenty tablicy.
Po pomyślnym zakończeniu operacji numer sekwencji podstawowej został zaktualizowany. Wszystkie rekordy dziennika z numerami sekwencji mniejsze niż nowy numer sekwencji podstawowej są niedostępne.
ReservationCollection Jeśli zostanie określony, zapisany obszar ponownego uruchamiania będzie zużywać miejsce, które zostało wcześniej zarezerwowane, przy użyciu rezerwacji zawartej w kolekcji. Jeśli metoda powiedzie się, będzie korzystać z najmniejszej rezerwacji, która może przechowywać dane, i że rezerwacja zostanie usunięta z kolekcji.
Jeśli sekwencja rekordów została usunięta lub jeśli przekazano nieprawidłowy argument, wyjątki są zgłaszane natychmiast w ramach tej operacji. Błędy, które wystąpiły podczas asynchronicznego żądania dołączania, na przykład błąd dysku podczas żądania we/wy, spowodują zgłoszenie wyjątków podczas wywoływanej EndWriteRestartArea metody.