DocumentPaginator.GetPageAsync Metodo

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationCore.dll

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 -> unit

Public 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

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. Il DocumentPage viene passato all'evento come uno degli argomenti dell'evento.

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

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

2. Chiamare GetPageAsync(Int32, Object) specificare il pageNumber desiderato e un userStateunivoco, che verrà usato per identificare il completamento dell'evento asincrono.

3. Quando si verifica l'evento e viene chiamato il delegato, confrontare il GetPageCompletedEventArgsdell'evento .UserState proprietà con il parametro GetPageAsync(Int32, Object)userState originale. La proprietà GetPageCompletedEventArgs.PageNumber corrisponderà anche al pageNumber specificato nella chiamata GetPageAsync(Int32, Object).

4. Quando il GetPageCompletedEventArgs.UserState proprietà corrisponde al GetPageAsync(Int32, Object)userStateoriginale, l'operazione è stata completata e la pagina è pronta.

5. Chiamare GetPage per recuperare il DocumentPageformattato.

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 -> unit

Public Overridable Sub GetPageAsync (pageNumber As Integer)

Parametri

pageNumber

Int32

Numero di pagina in base zero della pagina del documento necessaria.

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. 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).