DocumentPaginator.GetPageAsync DocumentPaginator.GetPageAsync DocumentPaginator.GetPageAsync DocumentPaginator.GetPageAsync Method

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

Die nullbasierte Seitenzahl der abzurufenden DocumentPage.The zero-based page number of the DocumentPage to get.

userState
Object Object Object Object

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

Ausnahmen

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. 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 DocumentPage asynchron abrufen:The following steps illustrate how to retrieve a DocumentPage asynchronously:

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

  2. Ruft GetPageAsync(Int32, Object) auf, pageNumber um den gewünschten und userStateeinen eindeutigen anzugeben, 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 GetPageCompletedEventArgsdes Ereignisses.UserStateWhen the event occurs and the delegate is called, compare the event's GetPageCompletedEventArgs.UserState -Eigenschaft mit dem GetPageAsync(Int32, Object) ursprünglichen userState Parameter.property with the original GetPageAsync(Int32, Object) userState parameter. (Die GetPageCompletedEventArgs.PageNumber(The GetPageCompletedEventArgs.PageNumber die-Eigenschaft entspricht auch pageNumber der GetPageAsync(Int32, Object) im-Befehl angegebenen.)property will also match the pageNumber specified in the GetPageAsync(Int32, Object) call.)

  4. GetPageCompletedEventArgsBeim.UserStateWhen the GetPageCompletedEventArgs.UserState die-Eigenschaft entspricht GetPageAsync(Int32, Object) der ursprünglichen 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 GetPage Sie auf, um DocumentPagedas formatierte abzurufen.Call GetPage to retrieve the formatted DocumentPage.

GetPageAsync(Int32) GetPageAsync(Int32) GetPageAsync(Int32) 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 Int32 Int32 Int32

Die nullbasierte Seitenzahl der benötigten Dokumentseite.The zero-based page number of the document page that is needed.

Ausnahmen

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. 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 GetPageAsync(Int32, Object) dazu, wie diese Methode zum Anzeigen der Seite verwendet wird, finden Sie unter.See GetPageAsync(Int32, Object) for how to use this method to get the page.

Gilt für: