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 il DocumentPage per il numero di pagina specificato.
Overload
| GetPageAsync(Int32, Object) |
Restituisce in modo asincrono (tramite l'evento GetPageCompleted) il 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) il DocumentPage per il numero di pagina specificato. |
GetPageAsync(Int32, Object)
Restituisce in modo asincrono (tramite l'evento GetPageCompleted) il 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 -> unitPublic Overridable Sub GetPageAsync (pageNumber As Integer, userState As Object)Parametri
- pageNumber
- Int32
Numero di pagina in base zero del 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. Il DocumentPage viene passato all'evento come uno degli argomenti dell'evento.
La procedura seguente illustra come recuperare un DocumentPage in modo asincrono:
Creare un delegato GetPageCompletedEventHandler e aggiungerlo per ricevere una notifica degli eventi GetPageCompleted.
Chiamare GetPageAsync(Int32, Object) specificare il
pageNumberdesiderato e unuserStateunivoco, che verrà usato per identificare il completamento dell'evento asincrono.Quando si verifica l'evento e viene chiamato il delegato, confrontare il GetPageCompletedEventArgsdell'evento .UserState proprietà con il parametro GetPageAsync(Int32, Object)
userStateoriginale. La proprietà GetPageCompletedEventArgs.PageNumber corrisponderà anche alpageNumberspecificato nella chiamata GetPageAsync(Int32, Object).Quando il GetPageCompletedEventArgs.UserState proprietà corrisponde al GetPageAsync(Int32, Object)
userStateoriginale, l'operazione è stata completata e la pagina è pronta.Chiamare GetPage per recuperare il DocumentPageformattato.
Si applica a
GetPageAsync(Int32)
Restituisce in modo asincrono (tramite l'evento GetPageCompleted) il 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 -> 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. Contrasto con l'altro overload di questo metodo: GetPageAsync(Int32, Object).
Questo metodo genera l'evento GetPageCompleted. Il DocumentPage viene passato all'evento come uno degli argomenti dell'evento. Per informazioni su come usare questo metodo per ottenere la pagina, vedere GetPageAsync(Int32, Object).
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).
