NavigationService.NavigationProgress Ereignis

  • Referenz

Definition

Namespace:
System.Windows.Navigation
Assembly:
PresentationFramework.dll

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

NavigationProgressEventHandler

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.

Gilt für:

Weitere Informationen