DocumentPaginator.GetPageAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Documents
Assembly:
PresentationCore.dll

Restituisce in modo asincrono DocumentPage per il numero di pagina specificato.

Overload

GetPageAsync(Int32, Object)

Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) DocumentPage per il numero di pagina specificato e assegna l'ID specificato all'attività asincrona.
GetPageAsync(Int32)

Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) DocumentPage per il numero di pagina specificato.

GetPageAsync(Int32, Object)

Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) DocumentPage per il numero di pagina specificato e assegna l'ID specificato all'attività asincrona.

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)

Parametri

pageNumber
Int32

Numero di pagina in base zero di DocumentPage da ottenere.

userState
Object

Identificatore univoco per l'attività asincrona.

Eccezioni

ArgumentOutOfRangeException

pageNumber è negativo.

Commenti

Questo overload del metodo consente di annullare questa operazione asincrona senza annullare tutte le operazioni asincrone.

Questo metodo genera l'evento GetPageCompleted . L'oggetto DocumentPage viene passato all'evento come uno degli argomenti dell'evento.

La procedura seguente illustra come recuperare un oggetto DocumentPage in modo asincrono:

  1. Creare un GetPageCompletedEventHandler delegato e aggiungerlo per ricevere una notifica degli GetPageCompleted eventi.

  2. Chiamata GetPageAsync(Int32, Object) che specifica il pageNumber valore desiderato e un oggetto univoco userStateche verrà usato per identificare il completamento dell'evento asincrono.

  3. Quando si verifica l'evento e viene chiamato il delegato, confrontare la proprietà dell'evento GetPageCompletedEventArgsUserState con il parametro originaleGetPageAsync(Int32, Object)userState. La GetPageCompletedEventArgsproprietà .PageNumber corrisponderà anche all'oggetto pageNumber specificato nella GetPageAsync(Int32, Object) chiamata.

  4. Quando la GetPageCompletedEventArgsproprietà .UserState corrisponde all'originale GetPageAsync(Int32, Object)userState, l'operazione è stata completata e la pagina è pronta.

  5. Chiamare GetPage per recuperare il formato DocumentPage.

Si applica a

GetPageAsync(Int32)

Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) DocumentPage per il numero di pagina specificato.

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)

Parametri

pageNumber
Int32

Il numero di pagina in base zero della pagina del documento necessario.

Eccezioni

ArgumentOutOfRangeException

pageNumber è negativo.

Commenti

L'unico modo per annullare l'operazione asincrona di questo metodo consiste nell'annullare tutte le operazioni asincrone. Contrasto con l'altro overload di questo metodo: GetPageAsync(Int32, Object).

Questo metodo genera l'evento GetPageCompleted . L'oggetto DocumentPage viene passato all'evento come uno degli argomenti dell'evento. Per ottenere la pagina, vedere GetPageAsync(Int32, Object) come usare questo metodo.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da GetPage(Int32).

Si applica a