NavigationService.NavigationProgress Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs periodically during a download to provide navigation progress information.
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 Event Type
Examples
The following example shows how to handle 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
Remarks
NavigationProgress is passed a NavigationProgressEventArgs which exposes the following progress information:
NavigationProgress is raised once for every 1024 bytes of content downloaded, and once more if the number of remaining bytes is ever less than 1024 bytes. For this reason, handling NavigationProgress provides a useful way to track and display the progress of a current download.
NavigationProgress won't be raised in some cases, such as when the same piece of content is navigated to, or when a content fragment is navigated to on content that is currently loaded (that is, the value of the Content property).
When navigating to a compiled XAML resource, the final NavigationProgress event may not be raised. This means that at the end of the download, the last reported BytesRead value may not equal the MaxBytes value. Handle the LoadCompleted event to be notified when the navigation has finished.
Note
When NavigationService raises NavigationProgress, it also raises Application.NavigationProgress event on the Application object.
