Udostępnij za pośrednictwem


PageContent.GetPageRootAsync(Boolean) Metoda

Definicja

Asynchronicznie ładuje i zwraca FixedPage element zawartości.

public:
 void GetPageRootAsync(bool forceReload);
public void GetPageRootAsync (bool forceReload);
member this.GetPageRootAsync : bool -> unit
Public 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:

  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ż