DynamicDocumentPaginator.GetPageNumberAsync Methode

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)

Parameters

Opmerkingen

De enige manier om de asynchrone bewerking van deze methode te annuleren, is door alle asynchrone bewerkingen te annuleren. Vergelijk dit met de andere overbelasting van deze methode: GetPageNumberAsync(ContentPosition, Object).

Met deze methode wordt de GetPageNumberCompleted gebeurtenis gegenereerd. Het paginanummer wordt als een van de gebeurtenisargumenten doorgegeven aan de gebeurtenis. Zie GetPageNumberAsync(ContentPosition, Object) hoe u deze methode gebruikt om het paginanummer op te halen.

Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door GetPageNumber(ContentPosition)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.

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)

Parameters

Opmerkingen

Deze overbelasting van de methode maakt het mogelijk om deze asynchrone bewerking te annuleren zonder alle asynchrone bewerkingen te annuleren.

Met deze methode wordt de GetPageNumberCompleted gebeurtenis gegenereerd.

De volgende stappen laten zien hoe u het paginanummer van een bepaalde contentPosition asynchroon ophaalt.

1. Maak een GetPageNumberCompletedEventHandler gemachtigde en voeg deze toe om op de hoogte te worden gesteld van GetPageNumberCompleted gebeurtenissen.

2. Aanroep GetPageNumberAsync(ContentPosition, Object) die het contentPosition gewenste en een uniek userState object opgeeft dat wordt gebruikt om de asynchrone taak te identificeren.

3. Wanneer de gebeurtenis plaatsvindt en de gemachtigde wordt aangeroepen, vergelijkt u de eigenschap .GetPageNumberCompletedEventArgs van de gebeurtenis UserStatemet de oorspronkelijke GetPageNumberAsyncuserState parameter.

4. Wanneer de GetPageNumberCompletedEventArgseigenschap .UserState overeenkomt met het origineel GetPageNumberAsync(ContentPosition, Object)userState, is de bewerking voltooid en is het paginanummer gereed. (De GetPageNumberCompletedEventArgseigenschap .ContentPosition komt ook overeen met de oorspronkelijke GetPageNumberAsync(ContentPosition, Object)contentPosition parameter.)

5. De GetPageNumberCompletedEventArgseigenschap .PageNumber bevat het op nul gebaseerde paginanummer van het opgegeven contentPosition.

GetPageNumber biedt vergelijkbare functionaliteit als GetPageNumberAsync, maar voor synchrone bewerking.