DynamicDocumentPaginator.GetPageNumberAsync Metodo

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition)

Parametri

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: GetPageNumberAsync(ContentPosition, Object).

Questo metodo genera l'evento GetPageNumberCompleted . Il numero di pagina viene passato all'evento come uno degli argomenti dell'evento. Vedere GetPageNumberAsync(ContentPosition, Object) come usare questo metodo per ottenere il numero di pagina.

Questo metodo archivia nell'attività 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 GetPageNumber(ContentPosition).

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition, System::Object ^ userState);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition, object userState);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition, userState As Object)

Parametri

Commenti

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

Questo metodo genera l'evento GetPageNumberCompleted .

I passaggi seguenti illustrano come recuperare il numero di pagina di un dato contentPosition in modo asincrono.

1. Creare un GetPageNumberCompletedEventHandler delegato e aggiungerlo per ricevere una notifica degli GetPageNumberCompleted eventi.

2. Chiamare GetPageNumberAsync(ContentPosition, Object) che specifica l'oggetto contentPosition desiderato e un oggetto univoco userState che verrà usato per identificare l'attività asincrona.

3. Quando si verifica l'evento e viene chiamato il delegato, confrontare la proprietà dell'evento GetPageNumberCompletedEventArgsUserState con il parametro originaleGetPageNumberAsyncuserState.

4. Quando la GetPageNumberCompletedEventArgsproprietà .UserState corrisponde all'originale GetPageNumberAsync(ContentPosition, Object)userState, l'operazione viene completata e il numero di pagina è pronto. La GetPageNumberCompletedEventArgsproprietà .ContentPosition corrisponderà anche al parametro originale GetPageNumberAsync(ContentPosition, Object)contentPosition .

5. La GetPageNumberCompletedEventArgsproprietà .PageNumber contiene il numero di pagina in base zero dell'oggetto specificato contentPosition.

GetPageNumber offre funzionalità simili a GetPageNumberAsync, ma per l'operazione sincrona.