DocumentPaginator.GetPageAsync Metoda

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationCore.dll

Asynchronicznie zwraca DocumentPage dla określonego numeru strony.

Przeciążenia

GetPageAsync(Int32, Object)	Asynchronicznie zwraca (za pośrednictwem zdarzenia GetPageCompleted) DocumentPage dla określonego numeru strony i przypisuje określony identyfikator do zadania asynchronicznego.
GetPageAsync(Int32)	Asynchronicznie zwraca (za pośrednictwem zdarzenia GetPageCompleted) DocumentPage dla określonego numeru strony.

GetPageAsync(Int32, Object)

Asynchronicznie zwraca (za pośrednictwem zdarzenia GetPageCompleted) 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 opartej na zera DocumentPage do pobrania.

userState

Object

Unikatowy identyfikator zadania asynchronicznego.

Wyjątki

ArgumentOutOfRangeException

pageNumber jest ujemna.

Uwagi

To przeciążenie metody umożliwia anulowanie tej operacji asynchronicznej bez anulowania wszystkich operacji asynchronicznych.

Ta metoda zgłasza zdarzenie GetPageCompleted. DocumentPage jest przekazywany do zdarzenia jako jeden z argumentów zdarzenia.

Poniższe kroki ilustrują sposób pobierania DocumentPage asynchronicznie:

1. Utwórz delegata GetPageCompletedEventHandler i dodaj go, aby otrzymywać powiadomienia o zdarzeniach GetPageCompleted.

2. Wywołaj GetPageAsync(Int32, Object) określając żądany pageNumber i unikatowy userState, który będzie używany do identyfikowania zakończenia zdarzenia asynchronicznego.

3. Po wystąpieniu zdarzenia i wywołaniu delegata porównaj GetPageCompletedEventArgszdarzenia .UserState właściwość z oryginalnym parametrem GetPageAsync(Int32, Object)userState. (Właściwość GetPageCompletedEventArgs.PageNumber będzie również zgodna z pageNumber określonym w wywołaniu GetPageAsync(Int32, Object)).

4. Gdy GetPageCompletedEventArgs.UserState właściwość odpowiada oryginalnej GetPageAsync(Int32, Object)userState, operacja jest zakończona i strona jest gotowa.

5. Wywołaj GetPage, aby pobrać sformatowany DocumentPage.

GetPageAsync(Int32)

Asynchronicznie zwraca (za pośrednictwem zdarzenia GetPageCompleted) 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óra jest wymagana, jest oparta na zera.

Wyjątki

ArgumentOutOfRangeException

pageNumber jest ujemna.

Uwagi

Jedynym sposobem anulowania operacji asynchronicznej tej metody jest anulowanie wszystkich operacji asynchronicznych. Porównaj to z innym przeciążeniem tej metody: GetPageAsync(Int32, Object).

Ta metoda zgłasza zdarzenie GetPageCompleted. DocumentPage jest przekazywany do zdarzenia jako jeden z argumentów zdarzenia. Aby uzyskać stronę, zobacz GetPageAsync(Int32, Object), aby użyć tej metody.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez GetPage(Int32).