DocumentPaginator.GetPageAsync Methode

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationCore.dll

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

Überlädt

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

GetPageAsync(Int32, Object)

Gibt (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl asynchron 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 der abzurufenden DocumentPage.

userState

Object

Ein eindeutiger Bezeichner für die asynchrone Aufgabe.

Ausnahmen

ArgumentOutOfRangeException

pageNumber ist ein negativer Wert.

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

Die folgenden Schritte veranschaulichen, wie ein DocumentPage asynchron abgerufen wird:

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

2. Rufen Sie GetPageAsync(Int32, Object) auf, indem Sie die pageNumber gewünschte und eine eindeutige userStateangeben, die verwendet wird, um die Vervollständigung des asynchronen Ereignisses zu identifizieren.

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

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

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

GetPageAsync(Int32)

Gibt (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl asynchron 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 ein negativer Wert.

Hinweise

Die einzige Möglichkeit, den asynchronen Vorgang dieser Methode abzubrechen, 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 wird als eines der Ereignisargumente an das -Ereignis übergeben. Informationen zum Abrufen der Seite finden Sie GetPageAsync(Int32, Object) unter Verwenden dieser Methode.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten GetPage(Int32)Ausnahmen.