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
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 -> unit
Public 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 był powiadamiany o zdarzeniach GetPageCompleted .
Wywołaj GetPageAsync(Int32, Object) metodę określającą
pageNumber
żądany i unikatowyuserState
element , 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)
userState
parametrem. (Właściwość GetPageCompletedEventArgs.PageNumber będzie również zgodna z wartościąpageNumber
określoną w wywołaniu GetPageAsync(Int32, Object) ).GetPageCompletedEventArgsGdy właściwość .UserState jest zgodna z oryginalną GetPageAsync(Int32, Object)
userState
właściwością , 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 -> unit
Public Overridable Sub GetPageAsync (pageNumber As Integer)
Parametry
- pageNumber
- Int32
Numer strony dokumentu, który jest potrzebny na podstawie zera.
Wyjątki
pageNumber
jest ujemna.
Uwagi
Jedynym sposobem anulowania operacji asynchronicznej tej metody jest anulowanie wszystkich operacji asynchronicznych. Należy to porównać 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 jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez GetPage(Int32)usługę .
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla