DynamicDocumentPaginator.GetPageNumberAsync Metod

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)

Parametrar

Kommentarer

Det enda sättet att avbryta den asynkrona åtgärden för den här metoden är att avbryta alla asynkrona åtgärder. Jämför detta med den andra överlagringen av den här metoden: GetPageNumberAsync(ContentPosition, Object).

Den här metoden genererar händelsen GetPageNumberCompleted . Sidnumret skickas till händelsen som ett av händelseargumenten. Se GetPageNumberAsync(ContentPosition, Object) hur du använder den här metoden för att hämta sidnumret.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av 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)

Parametrar

Kommentarer

Den här överbelastningen av metoden gör det möjligt att avbryta den här asynkrona åtgärden utan att avbryta alla asynkrona åtgärder.

Den här metoden genererar händelsen GetPageNumberCompleted .

Följande steg visar hur du hämtar sidnumret för en viss contentPosition asynkront.

1. Skapa ett GetPageNumberCompletedEventHandler ombud och lägg till det för att meddelas om GetPageNumberCompleted händelser.

2. Anrop GetPageNumberAsync(ContentPosition, Object) som anger önskat contentPosition och ett unikt userState objekt som ska användas för att identifiera den asynkrona aktiviteten.

3. När händelsen inträffar och ombudet anropas jämför du händelsens GetPageNumberCompletedEventArgs.UserState -egenskap med den ursprungliga GetPageNumberAsyncuserState parametern.

4. När egenskapen GetPageNumberCompletedEventArgs.UserState matchar det ursprungliga GetPageNumberAsync(ContentPosition, Object)userStateslutförs åtgärden och sidnumret är klart. (Egenskapen GetPageNumberCompletedEventArgs.ContentPosition matchar också den ursprungliga GetPageNumberAsync(ContentPosition, Object)contentPosition parametern.)

5. Egenskapen GetPageNumberCompletedEventArgs.PageNumber innehåller det nollbaserade sidnumret för den angivna contentPosition.

GetPageNumber innehåller liknande funktioner som GetPageNumberAsync, men för synkron åtgärd.