PageContent.GetPageRootAsync(Boolean) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Asynchronicznie ładuje i zwraca FixedPage element zawartości.
public:
void GetPageRootAsync(bool forceReload);public void GetPageRootAsync (bool forceReload);member this.GetPageRootAsync : bool -> unitPublic Sub GetPageRootAsync (forceReload As Boolean)Parametry
- forceReload
- Boolean
true aby zawsze ponownie załadować FixedPage plik, nawet jeśli został wcześniej załadowany i buforowany; false aby załadować FixedPage tylko wtedy, gdy nie ma buforowanej wersji.
Uwagi
GetPageRootAsync asynchronicznie ładuje i analizuje FixedPage strumień danych skojarzony z tym PageContentelementem . Inne wątki będą nadal działać po GetPageRootAsync zakończeniu.
Poniższe kroki ilustrują sposób ładowania FixedPage zawartości asynchronicznie:
Utwórz delegata GetPageRootCompletedEventHandler i dodaj go, aby otrzymywać powiadomienia o zdarzeniach GetPageRootCompleted .
Wywołaj polecenie GetPageRootAsync.
Po wystąpieniu GetPageRootCompleted zdarzenia i wywołaniu delegata FixedPage zawartość została zakończona ładowanie. Załadowany FixedPage element jest zwracany za pośrednictwem GetPageRootCompletedEventArgswłaściwości .Result
Aby uzyskać więcej informacji na temat <PageContent> elementu, zobacz rozdział 3 specyfikacji XPS, który można uzyskać na stronie XPS: Specyfikacja i pliki do pobrania licencji.
Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez GetPageRoot(Boolean)usługę .
