NavigationService.NavigationProgress 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在下載期間定期發生以提供導覽進度資訊。
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 公開下列進度資訊的 :
NavigationProgress 會針對每 1024 個下載的內容位元組引發一次,如果剩餘的位元組數目小於 1024 個位元組,則會再引發一次。 基於這個理由,處理 NavigationProgress 提供實用的方法來追蹤和顯示目前下載的進度。
NavigationProgress 在某些情況下不會引發,例如當流覽相同的內容片段時,或在目前載入的內容 (上巡覽至內容片段時,也就是 屬性的值 Content) 。
巡覽至已編譯的 XAML 資源時,可能不會引發最終 NavigationProgress 事件。 這表示在下載結束時,最後回報 BytesRead 的值可能不等於 MaxBytes 值。 處理事件, LoadCompleted 以在導覽完成時收到通知。
注意
當 引發 NavigationProgress 時 NavigationService ,也會在 物件上 Application 引發 Application.NavigationProgress 事件。