PageContent.GetPageRootAsync(Boolean) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Laadt asynchroon en retourneert het FixedPage inhoudselement.
public:
void GetPageRootAsync(bool forceReload);
public void GetPageRootAsync(bool forceReload);
member this.GetPageRootAsync : bool -> unit
Public Sub GetPageRootAsync (forceReload As Boolean)
Parameters
- forceReload
- Boolean
trueom altijd opnieuw te laden, zelfs als deze eerder is geladen en in de cache is opgeslagen. false Als u de FixedPage enige versie wilt laden als er geen versie in de FixedPage cache is.
Opmerkingen
GetPageRootAsync asynchroon laadt en parseert de FixedPage gegevensstroom die aan deze PageContentstroom is gekoppeld. Andere threads blijven actief terwijl GetPageRootAsync ze zijn voltooid.
De volgende stappen laten zien hoe u de FixedPage inhoud asynchroon laadt:
Maak een GetPageRootCompletedEventHandler gemachtigde en voeg deze toe om op de hoogte te worden gesteld van GetPageRootCompleted gebeurtenissen.
Roep GetPageRootAsync aan.
Wanneer de GetPageRootCompleted gebeurtenis plaatsvindt en de gemachtigde wordt aangeroepen, is de FixedPage inhoud geladen. Het geladen FixedPage element wordt geretourneerd via de GetPageRootCompletedEventArgseigenschap .Result
Zie hoofdstuk 3 van de XPS-specificatie die u kunt verkrijgen op XPS: Specificatie en licentiedownloads voor meer informatie over het <PageContent> element.
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 GetPageRoot(Boolean)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.