DocumentPaginator.GetPageAsync Metoda

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationCore.dll

Asynchronně vrátí DocumentPage pro zadané číslo stránky.

Přetížení

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

GetPageAsync(Int32, Object)

Asynchronně vrátí (prostřednictvím události GetPageCompleted) DocumentPage pro 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 DocumentPage 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. DocumentPage se události 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 GetPageCompleted událostech.

2. Volání GetPageAsync(Int32, Object) určení požadovaného pageNumber a jedinečného 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 GetPageCompletedEventArgsudálosti .UserState vlastnost s původním parametrem GetPageAsync(Int32, Object)userState. (Vlastnost GetPageCompletedEventArgs.PageNumber také odpovídá pageNumber zadanému ve volání GetPageAsync(Int32, Object).)

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

5. Voláním GetPage načtěte formátovaný DocumentPage.

GetPageAsync(Int32)

Asynchronně vrátí (prostřednictvím události GetPageCompleted) DocumentPage 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 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. DocumentPage se události předá jako jeden z argumentů události. Informace o tom, jak tuto metodu použít k získání stránky, najdete v GetPageAsync(Int32, Object).

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ě. U uložených výjimek se podívejte na výjimky vyvolané GetPage(Int32).