Поделиться через


NavigationService.NavigationProgress Событие

Определение

Происходит периодически во время загрузки, тем самым предоставляя информацию о ходе процесса навигации.

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.

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 , который предоставляет следующие сведения о ходе выполнения:

  • Число скачанных байтов (BytesRead).

  • Общее число скачиваемых байтов (MaxBytes).

NavigationProgress вызывается один раз для каждых 1024 байт скачаемого содержимого и еще раз, если количество оставшихся байтов когда-либо меньше 1024 байт. По этой причине обработка NavigationProgress предоставляет полезный способ отслеживания и отображения хода выполнения текущей загрузки.

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

При переходе к скомпилированному ресурсу XAML окончательное NavigationProgress событие может не вызываться. Это означает, что в конце загрузки последнее сообщаемое BytesRead значение может не совпадать со значением MaxBytes . Обработайте LoadCompleted событие, чтобы получать уведомления по завершении навигации.

Примечание

Когда NavigationService вызывает NavigationProgress, он также вызывает Application.NavigationProgress событие для Application объекта .

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

См. также раздел