DocumentPaginator.GetPageAsync Metoda

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationCore.dll

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

ArgumentOutOfRangeException

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 :

1. Vytvořte delegáta GetPageCompletedEventHandler a přidejte ho, abyste byli informováni o událostech GetPageCompleted .

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

3. 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ídat pageNumber vlastnosti zadané ve GetPageAsync(Int32, Object) volání.)

4. Když vlastnost GetPageCompletedEventArgs.UserState odpovídá původnímu GetPageAsync(Int32, Object)userStateobjektu , operace je dokončená a stránka je připravená.

5. Voláním GetPage načtete formátovaný DocumentPage.

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

ArgumentOutOfRangeException

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