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 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
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.
Chiamata GetPageAsync(Int32, Object) che specifica il
pageNumber
valore desiderato e un oggetto univocouserState
che 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'oggettopageNumber
specificato nella GetPageAsync(Int32, Object) chiamata.Quando la GetPageCompletedEventArgsproprietà .UserState corrisponde all'originale GetPageAsync(Int32, Object)
userState
, l'operazione è stata completata e la pagina è pronta.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
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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per