DynamicDocumentPaginator.GetPageNumberAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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ę .
Dotyczy
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.
Utwórz delegata GetPageNumberCompletedEventHandler i dodaj go, aby otrzymywać powiadomienia o zdarzeniach GetPageNumberCompleted .
Wywołaj metodę GetPageNumberAsync(ContentPosition, Object) określającą
contentPosition
żądany i unikatowyuserState
obiekt, który będzie używany do identyfikowania zadania asynchronicznego.Po wystąpieniu zdarzenia i wywołaniu delegata porównaj właściwość zdarzenia GetPageNumberCompletedEventArgsUserState . z oryginalnym GetPageNumberAsync
userState
parametrem.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).Właściwość GetPageNumberCompletedEventArgs.PageNumber zawiera numer strony opartej na zerowym numerze określonej
contentPosition
wartości .
GetPageNumber zapewnia podobną funkcjonalność jako GetPageNumberAsync, ale w przypadku operacji synchronicznej.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla