DocumentPaginator.GetPageAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce in modo asincrono l'oggetto DocumentPage per il numero di pagina specificato.
Overload
| Nome | Descrizione |
|---|---|
| GetPageAsync(Int32, Object) |
Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) per DocumentPage il numero di pagina specificato e assegna l'ID specificato all'attività asincrona. |
| GetPageAsync(Int32) |
Restituisce in modo asincrono (tramite l'evento) l'oggetto GetPageCompletedDocumentPage per il numero di pagina specificato. |
GetPageAsync(Int32, Object)
Restituisce in modo asincrono (tramite l'evento GetPageCompleted ) per DocumentPage 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 -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer, userState As Object)Parametri
- pageNumber
- Int32
Numero di pagina in base zero dell'oggetto DocumentPage da ottenere.
- userState
- Object
Identificatore univoco per l'attività asincrona.
Eccezioni
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:
Creare un GetPageCompletedEventHandler delegato e aggiungerlo per ricevere una notifica degli GetPageCompleted eventi.
Chiamare GetPageAsync(Int32, Object) che specifica l'oggetto
pageNumberdesiderato e un oggetto univocouserStateche verrà usato per identificare il completamento dell'evento asincrono.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'oggettopageNumberGetPageAsync(Int32, Object) specificato nella chiamata.Quando la GetPageCompletedEventArgsproprietà .UserState corrisponde all'originale GetPageAsync(Int32, Object)
userState, l'operazione è stata completata e la pagina è pronta.Chiamare GetPage per recuperare l'oggetto formattato DocumentPage.
Si applica a
GetPageAsync(Int32)
Restituisce in modo asincrono (tramite l'evento) l'oggetto GetPageCompletedDocumentPage 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 -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer)Parametri
- pageNumber
- Int32
Numero di pagina in base zero della pagina del documento necessaria.
Eccezioni
pageNumber è negativo.
Commenti
L'unico modo per annullare l'operazione asincrona di questo metodo consiste nell'annullare tutte le operazioni asincrone. Contrasta 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. Vedere GetPageAsync(Int32, Object) per informazioni su come usare questo metodo per ottenere la pagina.
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).
