DocumentPaginator.GetPageAsync Metoda

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationCore.dll

Asynchronně vrátí DocumentPage hodnotu zadaného čísla stránky.

Přetížení

Name	Description
GetPageAsync(Int32, Object)	Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage zadané číslo stránky a přiřadí zadané ID asynchronnímu úkolu.
GetPageAsync(Int32)	Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage zadané číslo stránky.

GetPageAsync(Int32, Object)

Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage zadané číslo stránky a přiřadí zadané ID asynchronnímu úkolu.

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 založené na nule, 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 DocumentPage asynchronně:

1. Vytvořte delegáta GetPageCompletedEventHandler a přidejte ho, aby se dostávalo oznámení 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 vlastnost události GetPageCompletedEventArgsUserState s původním GetPageAsync(Int32, Object)userState parametrem. (Vlastnost GetPageCompletedEventArgs.PageNumber bude také odpovídat pageNumber zadanému GetPageAsync(Int32, Object) v volání.)

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

5. Volání GetPage pro načtení formátovaného DocumentPagesouboru .

GetPageAsync(Int32)

Asynchronně vrátí (prostřednictvím GetPageCompleted události) DocumentPage 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 založené na nule, které je potřeba.

Výjimky

ArgumentOutOfRangeException

pageNumber je negativní.

Poznámky

Jediným způsobem zrušení asynchronní operace této metody je zrušení všech asynchronních operací. Naproti tomu 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 všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané GetPage(Int32).