DocumentPaginator.GetPageAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Asynchronně vrátí DocumentPage hodnotu pro zadané číslo stránky.
Přetížení
GetPageAsync(Int32, Object) |
Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage hodnotu pro zadané číslo stránky a přiřadí zadané ID asynchronní úloze. |
GetPageAsync(Int32) |
Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage hodnotu pro zadané číslo stránky. |
GetPageAsync(Int32, Object)
Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage hodnotu pro zadané číslo stránky a přiřadí zadané ID asynchronní úloze.
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
Číslo stránky od nuly, které DocumentPage chcete získat.
- userState
- Object
Jedinečný identifikátor asynchronní úlohy.
Výjimky
pageNumber
je negativní.
Poznámky
Toto přetížení metody umožňuje zrušit tuto asynchronní operaci bez zrušení všech asynchronních operací.
Tato metoda vyvolá GetPageCompleted událost. Událost DocumentPage se předá jako jeden z argumentů události.
Následující kroky ukazují, jak načíst objekt asynchronně DocumentPage :
Vytvořte delegáta GetPageCompletedEventHandler a přidejte ho, abyste byli informováni o událostech GetPageCompleted .
Volání GetPageAsync(Int32, Object) určující
pageNumber
požadované a jedinečnéuserState
, které se použije k identifikaci dokončení asynchronní události.Když dojde k události a delegát je volána, porovnejte GetPageCompletedEventArgsvlastnost .UserState události s původním GetPageAsync(Int32, Object)
userState
parametrem. (Vlastnost GetPageCompletedEventArgs.PageNumber bude také odpovídatpageNumber
vlastnosti zadané ve GetPageAsync(Int32, Object) volání.)Když vlastnost GetPageCompletedEventArgs.UserState odpovídá původnímu GetPageAsync(Int32, Object)
userState
objektu , operace je dokončená a stránka je připravená.Voláním GetPage načtete formátovaný DocumentPage.
Platí pro
GetPageAsync(Int32)
Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage hodnotu pro zadané číslo stránky.
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
Číslo stránky dokumentu od nuly, které je potřeba.
Výjimky
pageNumber
je negativní.
Poznámky
Jediný způsob, jak zrušit asynchronní operaci této metody, je zrušit všechny asynchronní operace. Porovnejte ho s druhým přetížením této metody: GetPageAsync(Int32, Object).
Tato metoda vyvolá GetPageCompleted událost. Událost DocumentPage se předá jako jeden z argumentů události. Podívejte GetPageAsync(Int32, Object) se, jak tuto metodu použít k získání stránky.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetPage(Int32).
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro