Partilhar via


NavigationService.NavigationProgress Evento

Definição

Ocorre periodicamente durante um download para fornecer informações sobre o andamento da navegação.

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 

Tipo de evento

Exemplos

O exemplo a seguir mostra como lidar com 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

Comentários

NavigationProgress é passado um NavigationProgressEventArgs que expõe as seguintes informações de progresso:

  • Número de bytes baixados até agora (BytesRead).

  • Número de bytes totais a serem baixados (MaxBytes).

NavigationProgress é gerado uma vez para cada 1024 bytes de conteúdo baixado e, mais uma vez, se o número de bytes restantes for cada vez menor que 1024 bytes. Por esse motivo, a manipulação NavigationProgress fornece uma maneira útil de acompanhar e exibir o progresso de um download atual.

NavigationProgress não será gerado em alguns casos, como quando a mesma parte do conteúdo for navegada ou quando um fragmento de conteúdo for navegado para o conteúdo carregado no momento (ou seja, o valor da Content propriedade).

Ao navegar para um recurso XAML compilado, o evento final NavigationProgress pode não ser gerado. Isso significa que, no final do download, o último valor relatado BytesRead pode não ser igual ao MaxBytes valor. Manipule o LoadCompleted evento a ser notificado quando a navegação for concluída.

Observação

Quando NavigationService gera NavigationProgress, ele também aciona Application.NavigationProgress o evento no Application objeto .

Aplica-se a

Confira também