DynamicDocumentPaginator.GetPageNumberAsync Methode

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)

Parameter

Hinweise

Die einzige Möglichkeit zum Abbrechen des asynchronen Vorgangs dieser Methode besteht darin, alle asynchronen Vorgänge abzubrechen. Vergleichen Sie dies mit der anderen Überladung dieser Methode: GetPageNumberAsync(ContentPosition, Object).

Diese Methode löst das GetPageNumberCompleted Ereignis aus. Die Seitenzahl wird als eines der Ereignisargumente an das Ereignis übergeben. Hier erfahren Sie, wie Sie GetPageNumberAsync(ContentPosition, Object) diese Methode verwenden, um die Seitenzahl abzurufen.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von GetPageNumber(ContentPosition).

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)

Parameter

Hinweise

Diese Überladung der Methode ermöglicht es, diesen asynchronen Vorgang abzubrechen, ohne alle asynchronen Vorgänge abzubrechen.

Diese Methode löst das GetPageNumberCompleted Ereignis aus.

Die folgenden Schritte veranschaulichen das Abrufen der Seitenzahl eines angegebenen contentPosition asynchronen Vorgangs.

1. Erstellen Sie eine GetPageNumberCompletedEventHandler Stellvertretung, und fügen Sie sie hinzu, um über Ereignisse benachrichtigt GetPageNumberCompleted zu werden.

2. Rufen Sie die GetPageNumberAsync(ContentPosition, Object) Angabe des contentPosition gewünschten und eines eindeutigen userState Objekts auf, das zum Identifizieren der asynchronen Aufgabe verwendet wird.

3. Wenn das Ereignis auftritt und der Delegat aufgerufen wird, vergleichen Sie die EigenschaftUserState des Ereignisses GetPageNumberCompletedEventArgsmit dem ursprünglichen GetPageNumberAsyncuserState Parameter.

4. Wenn die GetPageNumberCompletedEventArgs.UserState -Eigenschaft mit dem Original GetPageNumberAsync(ContentPosition, Object)userStateübereinstimmt, ist der Vorgang abgeschlossen, und die Seitenzahl ist bereit. (Die GetPageNumberCompletedEventArgs.ContentPosition -Eigenschaft entspricht auch dem ursprünglichen GetPageNumberAsync(ContentPosition, Object)contentPosition Parameter.)

5. Die GetPageNumberCompletedEventArgs.PageNumber -Eigenschaft enthält die nullbasierte Seitenzahl der angegebenen contentPosition.

GetPageNumber bietet ähnliche Funktionen wie GetPageNumberAsync, aber für synchronen Betrieb.