Freigeben über

DocumentPaginator.GetPageAsync Methode

Definition

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

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

Überlädt

Name Beschreibung
GetPageAsync(Int32, Object)

Gibt asynchron (durch 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 (durch das GetPageCompleted Ereignis) die DocumentPage für die angegebene Seitenzahl zurück.

GetPageAsync(Int32, Object)

Gibt asynchron (durch 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 DocumentPage abzurufenden Zeichenblatts.

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. Das DocumentPage Ereignis wird als eines der Ereignisargumente übergeben.

Die folgenden Schritte veranschaulichen das asynchrone Abrufen eines DocumentPage Vorgangs:

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

  2. Rufen Sie die GetPageAsync(Int32, Object) Angabe des pageNumber gewünschten und eines eindeutigen userStateAufrufs auf, der verwendet wird, um den Abschluss des asynchronen Ereignisses zu identifizieren.

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

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

  5. Aufrufen GetPage zum Abrufen des formatierten DocumentPage.

Gilt für:

GetPageAsync(Int32)

Gibt asynchron (durch 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. Das DocumentPage Ereignis wird als eines der Ereignisargumente übergeben. Hier erfahren Sie, wie Sie GetPageAsync(Int32, Object) diese Methode verwenden, um die Seite 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 GetPage(Int32).

Gilt für: