DocumentPaginator.GetPageAsync Methode

Definition

Gibt die DocumentPage für die angegebene Seitenzahl asynchron zurück.Asynchronously returns the DocumentPage for the specified page number.

Ü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.Asynchronously returns (through the GetPageCompleted event) the DocumentPage for the specified page number and assigns the specified ID to the asynchronous task.

GetPageAsync(Int32)

Gibt (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl asynchron zurück.Asynchronously returns (through the GetPageCompleted event) the DocumentPage for the specified page number.

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.Asynchronously returns (through the GetPageCompleted event) the DocumentPage for the specified page number and assigns the specified ID to the asynchronous task.

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.The zero-based page number of the DocumentPage to get.

userState
Object

Ein eindeutiger Bezeichner für die asynchrone Aufgabe.A unique identifier for the asynchronous task.

Ausnahmen

pageNumber ist ein negativer Wert.pageNumber is negative.

Hinweise

Diese Überladung der-Methode ermöglicht es, diesen asynchronen Vorgang abzubrechen, ohne alle asynchronen Vorgänge abzubrechen.This overload of the method makes it possible to cancel this asynchronous operation without cancelling all asynchronous operations.

Diese Methode löst das GetPageCompleted-Ereignis aus.This method raises the GetPageCompleted event. Der DocumentPage wird als eines der Ereignis Argumente an das Ereignis übermittelt.The DocumentPage is passed to the event as one of the event arguments.

Die folgenden Schritte veranschaulichen, wie Sie eine DocumentPage asynchron abrufen:The following steps illustrate how to retrieve a DocumentPage asynchronously:

  1. Erstellen Sie einen GetPageCompletedEventHandler-Delegaten, und fügen Sie ihn für die Benachrichtigung über GetPageCompleted-Ereignisse hinzu.Create a GetPageCompletedEventHandler delegate and add it to be notified of GetPageCompleted events.

  2. Geben Sie GetPageAsync(Int32, Object) an, und geben Sie dabei den gewünschten pageNumber und einen eindeutigen userState an, der verwendet wird, um den Abschluss des asynchronen Ereignisses zu identifizieren.Call GetPageAsync(Int32, Object) specifying the pageNumber desired and a unique userState, which will be used to identify the completion of the asynchronous event.

  3. Wenn das Ereignis auftritt und der Delegat aufgerufen wird, vergleichen Sie die GetPageCompletedEventArgs. UserState des Ereignisses.When the event occurs and the delegate is called, compare the event's GetPageCompletedEventArgs.UserState -Eigenschaft mit dem ursprünglichen GetPageAsync(Int32, Object)-userState-Parameter.property with the original GetPageAsync(Int32, Object) userState parameter. (Der GetPageCompletedEventArgs. PageNumber(The GetPageCompletedEventArgs.PageNumber die-Eigenschaft entspricht auch dem im GetPageAsync(Int32, Object)-Befehl angegebenen pageNumber.)property will also match the pageNumber specified in the GetPageAsync(Int32, Object) call.)

  4. Wenn die GetPageCompletedEventArgs. UserStateWhen the GetPageCompletedEventArgs.UserState die Eigenschaft entspricht der ursprünglichen GetPageAsync(Int32, Object) userState, der Vorgang ist abgeschlossen, und die Seite ist bereit.property matches the original GetPageAsync(Int32, Object) userState, the operation is complete and the page is ready.

  5. Rufen Sie GetPage auf, um das formatierte DocumentPage abzurufen.Call GetPage to retrieve the formatted DocumentPage.

GetPageAsync(Int32)

Gibt (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl asynchron zurück.Asynchronously returns (through the GetPageCompleted event) the DocumentPage for the specified page number.

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.The zero-based page number of the document page that is needed.

Ausnahmen

pageNumber ist ein negativer Wert.pageNumber is negative.

Hinweise

Die einzige Möglichkeit, den asynchronen Vorgang dieser Methode abzubrechen, besteht darin, alle asynchronen Vorgänge abzubrechen.The only way to cancel the asynchronous operation of this method is to cancel all asynchronous operations. Vergleichen Sie dies mit der anderen Überladung dieser Methode: GetPageAsync(Int32, Object).Contrast this with the other overload of this method: GetPageAsync(Int32, Object).

Diese Methode löst das GetPageCompleted-Ereignis aus.This method raises the GetPageCompleted event. Der DocumentPage wird als eines der Ereignis Argumente an das Ereignis übermittelt.The DocumentPage is passed to the event as one of the event arguments. Informationen zum Verwenden dieser Methode zum Ermitteln der Seite finden Sie unter GetPageAsync(Int32, Object).See GetPageAsync(Int32, Object) for how to use this method to get the page.

Gilt für: