DocumentPaginator.GetPageAsync 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.
Asynchronicznie zwraca wartość DocumentPage dla określonego numeru strony.
Przeciążenia
| Nazwa | Opis |
|---|---|
| GetPageAsync(Int32, Object) |
Asynchronicznie zwraca wartość (za pośrednictwem GetPageCompleted zdarzenia) DocumentPage dla określonego numeru strony i przypisuje określony identyfikator do zadania asynchronicznego. |
| GetPageAsync(Int32) |
Asynchronicznie zwraca wartość (za pośrednictwem GetPageCompleted zdarzenia) DocumentPage dla określonego numeru strony. |
GetPageAsync(Int32, Object)
Asynchronicznie zwraca wartość (za pośrednictwem GetPageCompleted zdarzenia) DocumentPage dla określonego numeru strony i przypisuje określony identyfikator do zadania asynchronicznego.
public:
virtual void GetPageAsync(int pageNumber, System::Object ^ userState);public virtual void GetPageAsync(int pageNumber, object userState);abstract member GetPageAsync : int * obj -> unit
override this.GetPageAsync : int * obj -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer, userState As Object)Parametry
- pageNumber
- Int32
Numer strony zerowej DocumentPage do pobrania.
- userState
- Object
Unikatowy identyfikator zadania asynchronicznego.
Wyjątki
pageNumber jest ujemna.
Uwagi
To przeciążenie metody umożliwia anulowanie tej operacji asynchronicznej bez anulowania wszystkich operacji asynchronicznych.
Ta metoda zgłasza GetPageCompleted zdarzenie. Element DocumentPage jest przekazywany do zdarzenia jako jeden z argumentów zdarzenia.
Poniższe kroki ilustrują sposób pobierania DocumentPage asynchronicznego:
Utwórz delegata GetPageCompletedEventHandler i dodaj go, aby otrzymywać powiadomienia o zdarzeniach GetPageCompleted .
Wywołanie GetPageAsync(Int32, Object) określające
pageNumberżądany i unikatowyuserStateelement , który będzie używany do identyfikowania ukończenia zdarzenia asynchronicznego.Po wystąpieniu zdarzenia i wywołaniu delegata porównaj właściwość .UserState zdarzenia GetPageCompletedEventArgsz oryginalnym GetPageAsync(Int32, Object)
userStateparametrem. (Właściwość .PageNumber będzie również zgodna GetPageCompletedEventArgszpageNumberokreśloną w wywołaniuGetPageAsync(Int32, Object)).Gdy właściwość .UserState jest zgodna z oryginałemGetPageCompletedEventArgsGetPageAsync(Int32, Object)
userState, operacja zostanie ukończona, a strona jest gotowa.Wywołaj metodę GetPage , aby pobrać sformatowany DocumentPageelement .
Dotyczy
GetPageAsync(Int32)
Asynchronicznie zwraca wartość (za pośrednictwem GetPageCompleted zdarzenia) DocumentPage dla określonego numeru strony.
public:
virtual void GetPageAsync(int pageNumber);public virtual void GetPageAsync(int pageNumber);abstract member GetPageAsync : int -> unit
override this.GetPageAsync : int -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer)Parametry
- pageNumber
- Int32
Numer strony dokumentu, która jest wymagana, jest oparta na zera.
Wyjątki
pageNumber jest ujemna.
Uwagi
Jedynym sposobem anulowania operacji asynchronicznej tej metody jest anulowanie wszystkich operacji asynchronicznych. Porównaj to z innym przeciążeniem tej metody: GetPageAsync(Int32, Object).
Ta metoda zgłasza GetPageCompleted zdarzenie. Element DocumentPage jest przekazywany do zdarzenia jako jeden z argumentów zdarzenia. Zobacz GetPageAsync(Int32, Object) , jak za pomocą tej metody uzyskać stronę.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program GetPage(Int32).
