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 バイトごとに 1 回発生し、残りのバイト数が 1024 バイト未満の場合はもう 1 回発生します。 このため、処理 NavigationProgress は、現在のダウンロードの進行状況を追跡して表示する便利な方法を提供します。

NavigationProgress 場合によっては、同じコンテンツが移動されたときや、現在読み込まれているコンテンツ (つまり プロパティの Content 値) でコンテンツ フラグメントが に移動された場合など、発生しません。

コンパイル済み XAML リソースに移動すると、最終的な NavigationProgress イベントが発生しない可能性があります。 つまり、ダウンロードの最後に報告された BytesRead 値が値と MaxBytes 等しくない可能性があります。 ナビゲーションが LoadCompleted 完了したときに通知されるイベントを処理します。

注意

が 発生NavigationProgressするとNavigationService、 オブジェクトに対Applicationするイベントも発生Application.NavigationProgressします。

適用対象

こちらもご覧ください