PageContent.GetPageRootAsync(Boolean) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationFramework.dll

Asynchronicznie ładuje i zwraca FixedPage element zawartości.

C#

public void GetPageRootAsync(bool forceReload);

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:

1. Utwórz delegata GetPageRootCompletedEventHandler i dodaj go, aby otrzymywać powiadomienia o zdarzeniach GetPageRootCompleted .

2. Wywołaj polecenie GetPageRootAsync.

3. 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ę .

Dotyczy

Zobacz też

• GetPageRoot(Boolean)
• GetPageRootAsyncCancel()
• GetPageRootCompleted
• GetPageRootCompletedEventArgs
• GetPageRootCompletedEventHandler