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. Informationen zur Verwendung dieser Methode zum Abrufen der Seitenzahl finden Sie unter GetPageNumberAsync(ContentPosition, Object).

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. Verwendungs exceptions, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von GetPageNumber(ContentPosition)ausgelösten Ausnahmen.

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, wie die Seitenzahl eines bestimmten contentPosition asynchron abgerufen wird.

1. Erstellen Sie einen GetPageNumberCompletedEventHandler Delegat, und fügen Sie ihn hinzu, um über GetPageNumberCompleted Ereignisse benachrichtigt zu werden.

2. Rufen Sie GetPageNumberAsync(ContentPosition, Object) auf, um die gewünschte contentPosition anzugeben, und ein eindeutiges userState-Objekt, das zum Identifizieren der asynchronen Aufgabe verwendet wird.

3. Wenn das Ereignis auftritt und der Delegat aufgerufen wird, vergleichen Sie die GetPageNumberCompletedEventArgsdes Ereignisses.UserState Eigenschaft mit dem ursprünglichen GetPageNumberAsyncuserState-Parameter.

4. Wenn die GetPageNumberCompletedEventArgs.UserState Eigenschaft mit dem ursprünglichen GetPageNumberAsync(ContentPosition, Object)userStateübereinstimmt, ist der Vorgang abgeschlossen und die Seitenzahl ist fertig. (Die eigenschaft GetPageNumberCompletedEventArgs.ContentPosition 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.