DocumentPaginator.GetPageAsync Metoda

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationCore.dll

Asynchronicznie zwraca wartość DocumentPage dla określonego numeru strony.

Przeciążenia

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

GetPageAsync(Int32, Object)

Asynchronicznie zwraca wartość (za pośrednictwem GetPageCompleted zdarzenia) 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 zerowej 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 GetPageCompleted zdarzenie. Element DocumentPage jest przekazywany do zdarzenia jako jeden z argumentów zdarzenia.

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

1. Utwórz delegata GetPageCompletedEventHandler i dodaj go, aby był powiadamiany o zdarzeniach GetPageCompleted .

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

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

4. GetPageCompletedEventArgsGdy właściwość .UserState jest zgodna z oryginalną GetPageAsync(Int32, Object)userStatewłaściwością , operacja zostanie ukończona, a strona jest gotowa.

5. Wywołaj metodę GetPage , aby pobrać sformatowany DocumentPageelement .

GetPageAsync(Int32)

Asynchronicznie zwraca wartość (za pośrednictwem GetPageCompleted zdarzenia) 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óry jest potrzebny na podstawie zera.

Wyjątki

ArgumentOutOfRangeException

pageNumber jest ujemna.

Uwagi

Jedynym sposobem anulowania operacji asynchronicznej tej metody jest anulowanie wszystkich operacji asynchronicznych. Należy to porównać z innym przeciążeniem tej metody: GetPageAsync(Int32, Object).

Ta metoda zgłasza GetPageCompleted zdarzenie. Element DocumentPage jest przekazywany do zdarzenia jako jeden z argumentów zdarzenia. Zobacz GetPageAsync(Int32, Object) , jak za pomocą tej metody uzyskać stronę.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez GetPage(Int32)usługę .