DocumentPaginator.GetPageAsync Methode

  • Referenz

Definition

Namespace:
System.Windows.Documents
Assembly:
PresentationCore.dll

Gibt asynchron die DocumentPage für die angegebene Seitenzahl zurück.

Überlädt

GetPageAsync(Int32, Object)

Gibt asynchron (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl zurück und weist der asynchronen Aufgabe die angegebene ID zu.
GetPageAsync(Int32)

Gibt asynchron (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl zurück.

GetPageAsync(Int32, Object)

Gibt asynchron (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl zurück und weist der asynchronen Aufgabe die angegebene ID zu.

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)

Parameter

pageNumber
Int32

Die nullbasierte Seitenzahl des abzurufenden DocumentPage.

userState
Object

Ein eindeutiger Bezeichner für die asynchrone Aufgabe.

Ausnahmen

ArgumentOutOfRangeException

pageNumber ist negativ.

Hinweise

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

Diese Methode löst das GetPageCompleted-Ereignis aus. Die DocumentPage wird als eines der Ereignisargumente an das Ereignis übergeben.

Die folgenden Schritte veranschaulichen das asynchrone Abrufen einer DocumentPage:

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

  2. Rufen Sie GetPageAsync(Int32, Object) die gewünschte pageNumber und eine eindeutige userStatean, die verwendet wird, um den Abschluss des asynchronen Ereignisses zu identifizieren.

  3. Wenn das Ereignis auftritt und der Delegat aufgerufen wird, vergleichen Sie die GetPageCompletedEventArgsdes Ereignisses.UserState Eigenschaft mit dem ursprünglichen GetPageAsync(Int32, Object)userState-Parameter. (Die GetPageCompletedEventArgs.PageNumber-Eigenschaft entspricht auch dem im GetPageAsync(Int32, Object) Aufruf angegebenen pageNumber.)

  4. Wenn die GetPageCompletedEventArgs.UserState Eigenschaft mit dem ursprünglichen GetPageAsync(Int32, Object)userStateübereinstimmt, ist der Vorgang abgeschlossen und die Seite ist bereit.

  5. Rufen Sie GetPage auf, um die formatierte DocumentPageabzurufen.

Gilt für:

GetPageAsync(Int32)

Gibt asynchron (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl zurück.

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)

Parameter

pageNumber
Int32

Die nullbasierte Seitenzahl der benötigten Dokumentseite.

Ausnahmen

ArgumentOutOfRangeException

pageNumber ist negativ.

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: GetPageAsync(Int32, Object).

Diese Methode löst das GetPageCompleted-Ereignis aus. Die DocumentPage wird als eines der Ereignisargumente an das Ereignis übergeben. Informationen zur Verwendung dieser Methode zum Abrufen der Seite finden Sie unter GetPageAsync(Int32, 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 GetPage(Int32)ausgelösten Ausnahmen.

Gilt für: