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 傳遞的 會 NavigationProgressEventArgs 公開下列進度資訊的 ：

  • 到目前為止下載的位元組數 (BytesRead) 。

  • 要下載 () MaxBytes 的位元組總數。

NavigationProgress 會針對每 1024 個下載的內容位元組引發一次，如果剩餘的位元組數目小於 1024 個位元組，則會再引發一次。 基於這個理由，處理 NavigationProgress 提供實用的方法來追蹤和顯示目前下載的進度。

NavigationProgress 在某些情況下不會引發，例如當流覽相同的內容片段時，或在目前載入的內容 (上巡覽至內容片段時，也就是 屬性的值 Content) 。

巡覽至已編譯的 XAML 資源時，可能不會引發最終 NavigationProgress 事件。 這表示在下載結束時，最後回報 BytesRead 的值可能不等於 MaxBytes 值。 處理事件， LoadCompleted 以在導覽完成時收到通知。

注意

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

適用於

另請參閱