DynamicDocumentPaginator.GetPageNumberAsync Metoda

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationCore.dll

Zwraca numer strony opartej na zera określonej ContentPositionwartości .

Przeciążenia

GetPageNumberAsync(ContentPosition)	Asynchronicznie zwraca (za pomocą metody Ta metoda zgłasza GetPageNumberCompleted zdarzenie) numer strony opartej na zerowym numerze określonej ContentPositionwartości .
GetPageNumberAsync(ContentPosition, Object)	Asynchronicznie zwraca (za pomocą metody Ta metoda zgłasza GetPageNumberCompleted zdarzenie) numer strony opartej na zerowym numerze określonej ContentPositionwartości .

GetPageNumberAsync(ContentPosition)

Asynchronicznie zwraca (za pomocą metody Ta metoda zgłasza GetPageNumberCompleted zdarzenie) numer strony opartej na zerowym numerze określonej ContentPositionwartości .

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition)

Parametry

contentPosition

ContentPosition

Pozycja zawartości, której numer strony jest potrzebny.

Uwagi

Jedynym sposobem anulowania operacji asynchronicznej tej metody jest anulowanie wszystkich operacji asynchronicznych. Kontrastuje to z innym przeciążeniem tej metody: GetPageNumberAsync(ContentPosition, Object).

Ta metoda zgłasza GetPageNumberCompleted zdarzenie. Numer strony jest przekazywany do zdarzenia jako jeden z argumentów zdarzenia. Zobacz GetPageNumberAsync(ContentPosition, Object) , jak użyć tej metody, aby uzyskać numer strony.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez GetPageNumber(ContentPosition)usługę .

GetPageNumberAsync(ContentPosition, Object)

Asynchronicznie zwraca (za pomocą metody Ta metoda zgłasza GetPageNumberCompleted zdarzenie) numer strony opartej na zerowym numerze określonej ContentPositionwartości .

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition, System::Object ^ userState);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition, object userState);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition, userState As Object)

Parametry

contentPosition

ContentPosition

Element pozycji zawartości, aby zwrócić numer strony.

userState

Object

Unikatowy identyfikator zadania asynchronicznego.

Uwagi

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

Ta metoda zgłasza GetPageNumberCompleted zdarzenie.

Poniższe kroki ilustrują sposób pobierania numeru strony danej contentPosition asynchronicznej.

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

2. Wywołaj metodę GetPageNumberAsync(ContentPosition, Object) określającą contentPosition żądany i unikatowy userState obiekt, który będzie używany do identyfikowania zadania asynchronicznego.

3. Po wystąpieniu zdarzenia i wywołaniu delegata porównaj właściwość zdarzenia GetPageNumberCompletedEventArgsUserState . z oryginalnym GetPageNumberAsyncuserState parametrem.

4. GetPageNumberCompletedEventArgsGdy właściwość .UserState jest zgodna z oryginałemGetPageNumberAsync(ContentPosition, Object)userState, operacja zostanie ukończona, a numer strony jest gotowy. (Właściwość GetPageNumberCompletedEventArgs.ContentPosition będzie również zgodna z oryginalnym GetPageNumberAsync(ContentPosition, Object)contentPosition parametrem).

5. Właściwość GetPageNumberCompletedEventArgs.PageNumber zawiera numer strony opartej na zerowym numerze określonej contentPositionwartości .

GetPageNumber zapewnia podobną funkcjonalność jako GetPageNumberAsync, ale w przypadku operacji synchronicznej.