語言

NavigationService.NavigationProgress 活動

定義

命名空間:
System.Windows.Navigation
組件:
PresentationFramework.dll

在下載期間定期發生，以提供瀏覽進度資訊。

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

事件類型

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 傳遞 a NavigationProgressEventArgs 會顯示以下進度資訊：

  • 目前已下載的位元組數（BytesRead）。

  • 可下載的總位元組數（MaxBytes）。

NavigationProgress 每下載1024位元組，會升起一次，若剩餘位元組數永遠低於1024位元組，則再升一次。 因此，處理 NavigationProgress 提供了追蹤與顯示當前下載進度的有用方式。

NavigationProgress 在某些情況下，例如當導覽到同一內容，或是當前載入內容（即屬性值 Content ）時，則不會被檢出。

當導航到已編譯的 XAML 資源時，最終 NavigationProgress 事件可能不會被觸發。 這表示下載結束時，最後回報 BytesRead 的值可能不等於該 MaxBytes 值。 處理 LoadCompleted 該事件，當導航結束時會收到通知。

Note

當 NavigationService 升 NavigationProgress起 時，也會引發 Application.NavigationProgress 物件上的 Application 事件。

適用於

另請參閱