NavigationService.NavigationProgress NavigationService.NavigationProgress NavigationService.NavigationProgress NavigationService.NavigationProgress Event

Определение

Происходит периодически во время загрузки, тем самым предоставляя информацию о ходе процесса навигации.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 

Примеры

В следующем примере показано, как выполнить NavigationProgressобработку.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

Комментарии

NavigationProgressпередается NavigationProgressEventArgs , который предоставляет следующие сведения о ходе выполнения:NavigationProgress is passed a NavigationProgressEventArgs which exposes the following progress information:

  • Число байтов, скачанных на данныйBytesReadмомент ().Number of bytes downloaded so far (BytesRead).

  • Общее число байтов для скачивания (MaxBytes).Number of total bytes to download (MaxBytes).

NavigationProgressвызывается один раз для каждых 1024 байт содержимого и, если число оставшихся байт меньше 1024 байт.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. По этой причине обработка NavigationProgress предоставляет удобный способ отслеживания и просмотра хода выполнения текущего скачивания.For this reason, handling NavigationProgress provides a useful way to track and display the progress of a current download.

NavigationProgressне будет вызываться в некоторых случаях, например при переходе к тому же фрагменту содержимого или при переходе фрагмента содержимого к содержимому, которое в данный момент загружено (то есть значение Content свойства).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).

При переходе к скомпилированному XAML-ресурсу Последнее NavigationProgress событие может не возникнуть.When navigating to a compiled XAML resource, the final NavigationProgress event may not be raised. Это означает, что в конце загрузки Последнее сообщаемое BytesRead значение может не совпадать со MaxBytes значением.This means that at the end of the download, the last reported BytesRead value may not equal the MaxBytes value. Обработайте LoadCompleted событие, чтобы получать уведомления о завершении навигации.Handle the LoadCompleted event to be notified when the navigation has finished.

Примечание

При NavigationService вызове NavigationProgress Application.NavigationProgress онApplication также создает событие для объекта.When NavigationService raises NavigationProgress, it also raises Application.NavigationProgress event on the Application object.

Применяется к

Дополнительно