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 regelmäßig während eines Downloadvorgangs auf, um Informationen zum Navigationsstatus 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 behandelt wird 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
Hinweise
NavigationProgress wird ein NavigationProgressEventArgs übergeben, das die folgenden Statusinformationen verfügbar macht:
Anzahl der bisher heruntergeladenen Bytes (BytesRead).
Gesamtanzahl der herunterzuladenden Bytes (MaxBytes).
NavigationProgress wird einmal für jeden heruntergeladenen Inhalt von 1.024 Bytes und einmal mehr ausgelöst, wenn die Anzahl der verbleibenden Bytes jemals unter 1024 Bytes liegt. 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 zu demselben Inhalt navigiert wird, oder wenn ein Inhaltsfragment für Inhalte navigiert wird, die derzeit geladen werden (d. a. den Wert der Content Eigenschaft).
Beim Navigieren zu einer kompilierten XAML-Ressource wird das letzte NavigationProgress Ereignis möglicherweise nicht ausgelöst. Dies bedeutet, dass am Ende des Downloads der zuletzt gemeldete BytesRead Wert möglicherweise nicht dem MaxBytes Wert entspricht. Behandeln Sie das LoadCompleted Ereignis, das benachrichtigt werden soll, wenn die Navigation beendet ist.
Hinweis
Wenn NavigationService ausgelöst NavigationProgresswird, löst Application.NavigationProgress es auch ein Ereignis für das Application -Objekt aus.
