PageContent.GetPageRootAsync(Boolean) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Carica e restituisce in modo asincrono l'elemento del contenuto FixedPage.
public:
void GetPageRootAsync(bool forceReload);
public void GetPageRootAsync (bool forceReload);
member this.GetPageRootAsync : bool -> unit
Public Sub GetPageRootAsync (forceReload As Boolean)
Parametri
- forceReload
- Boolean
true
per ricaricare sempre l'oggetto FixedPage anche se è stato precedentemente caricato e memorizzato nella cache. false
per caricare l'oggetto FixedPage solo se non è disponibile alcuna versione memorizzata nella cache.
Commenti
GetPageRootAsync carica e analizza in modo asincrono il FixedPage flusso di dati associato a questo PageContentoggetto . Altri thread continueranno a essere eseguiti durante GetPageRootAsync il completamento.
La procedura seguente illustra come caricare il FixedPage contenuto in modo asincrono:
Creare un GetPageRootCompletedEventHandler delegato e aggiungerlo per ricevere una notifica degli GetPageRootCompleted eventi.
Chiamare GetPageRootAsync.
Quando si verifica l'evento e viene chiamato il GetPageRootCompleted delegato, il contenuto ha completato il FixedPage caricamento. L'elemento caricato FixedPage viene restituito tramite la GetPageRootCompletedEventArgsproprietà .Result
Per altre informazioni sull'elemento <PageContent>
, vedere il capitolo 3 della specifica XPS che è possibile ottenere in XPS: Specifica e Download delle licenze.
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 GetPageRoot(Boolean).