NavigationService.NavigationProgress Zdarzenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Navigation
Zestaw:
PresentationFramework.dll

Występuje okresowo podczas pobierania w celu udostępnienia informacji o postępie nawigacji.

public:
 event System::Windows::Navigation::NavigationProgressEventHandler ^ NavigationProgress;
public event System.Windows.Navigation.NavigationProgressEventHandler NavigationProgress;
member this.NavigationProgress : System.Windows.Navigation.NavigationProgressEventHandler 
Public Custom Event NavigationProgress As NavigationProgressEventHandler

Typ zdarzenia

NavigationProgressEventHandler

Przykłady

W poniższym przykładzie pokazano, jak obsłużyć usługę NavigationProgress.

void NavigationService_NavigationProgress(object sender, NavigationProgressEventArgs e)
{
    string msg = string.Format("{0} of {1} bytes retrieved.", e.BytesRead, e.MaxBytes);
    this.progressStatusBarItem.Content = msg;
}

Private Sub NavigationService_NavigationProgress(ByVal sender As Object, ByVal e As NavigationProgressEventArgs)
    Dim msg As String = String.Format("{0} of {1} bytes retrieved.", e.BytesRead, e.MaxBytes)
    Me.progressStatusBarItem.Content = msg
End Sub

Uwagi

NavigationProgress jest przekazywany, NavigationProgressEventArgs który uwidacznia następujące informacje o postępie:

  • Liczba bajtów pobranych do tej pory (BytesRead).

  • Liczba łącznych bajtów do pobrania (MaxBytes).

NavigationProgress jest zgłaszany raz dla każdego 1024 bajtów pobranej zawartości, a po raz kolejny, jeśli liczba pozostałych bajtów jest zawsze mniejsza niż 1024 bajtów. Z tego powodu obsługa NavigationProgress zapewnia przydatny sposób śledzenia i wyświetlania postępu bieżącego pobierania.

NavigationProgress w niektórych przypadkach nie zostanie podniesiony, na przykład wtedy, gdy ten sam element zawartości zostanie wyświetlony lub gdy fragment zawartości zostanie przekazany do zawartości, która jest aktualnie załadowana (czyli wartość Content właściwości).

Podczas przechodzenia do skompilowanego zasobu NavigationProgress XAML ostateczne zdarzenie może nie zostać podniesione. Oznacza to, że na końcu pobierania ostatnia zgłoszona BytesRead wartość może nie być równa MaxBytes wartości. LoadCompleted Obsłuż zdarzenie, aby otrzymywać powiadomienia po zakończeniu nawigacji.

Uwaga

W przypadku NavigationService wywołania NavigationProgressobiektu program zgłasza Application.NavigationProgress również zdarzenie Application .

Dotyczy

Zobacz też