NavigationService.NavigationProgress Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt in regelmäßigen Abständen während eines Downloads auf, um Navigationsfortschrittsinformationen bereitzustellen.
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 Ereignistyp
Beispiele
Das folgende Beispiel zeigt, wie sie behandelt NavigationProgresswerden.
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
Hinweise
NavigationProgress wird eine NavigationProgressEventArgs Übergeben, die die folgenden Statusinformationen verfügbar macht:
Anzahl der bisher heruntergeladenen Bytes (BytesRead).
Anzahl der Gesamtbytes, die heruntergeladen werden sollen (MaxBytes).
NavigationProgress wird einmal für alle 1024 Bytes von Inhalten ausgelöst, die heruntergeladen wurden, und einmal mehr, wenn die Anzahl der verbleibenden Bytes je weniger als 1024 Bytes beträgt. Aus diesem Grund bietet die Behandlung NavigationProgress eine nützliche Möglichkeit, den Fortschritt eines aktuellen Downloads nachzuverfolgen und anzuzeigen.
NavigationProgress wird in einigen Fällen nicht ausgelöst, z. B. wenn derselbe Teil des Inhalts navigiert wird, oder wenn ein Inhaltsfragment zu Inhalten navigiert wird, zu denen derzeit geladen wird (d. h. der Wert der Content Eigenschaft).
Wenn Sie zu einer kompilierten XAML-Ressource navigieren, wird das endgültige NavigationProgress Ereignis möglicherweise nicht ausgelöst. Dies bedeutet, dass der letzte gemeldete BytesRead Wert am Ende des Downloads möglicherweise nicht dem MaxBytes Wert entspricht. Behandeln Sie das LoadCompleted Ereignis, das benachrichtigt werden soll, wenn die Navigation abgeschlossen ist.
Hinweis
Wenn NavigationService das Objekt ausgelöst wirdNavigationProgress, löst es auch ein Ereignis für das Application Objekt ausApplication.NavigationProgress.
