共用方式為


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 以在導覽完成時收到通知。

注意

當 引發 NavigationProgressNavigationService ,也會在 物件上 Application 引發 Application.NavigationProgress 事件。

適用於

另請參閱