NavigationService.NavigationProgress Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre periodicamente durante o download para fornecer informação sobre o progresso 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 seguinte mostra como lidar NavigationProgresscom .
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
Observações
NavigationProgress é passado a NavigationProgressEventArgs que expõe a seguinte informação de progresso:
Número de bytes descarregados até agora (BytesRead).
Número total de bytes a descarregar (MaxBytes).
NavigationProgress é aumentado uma vez por cada 1024 bytes de conteúdo descarregado, e outra vez se o número de bytes restantes for alguma vez inferior a 1024 bytes. Por esta razão, o handling NavigationProgress oferece uma forma útil de acompanhar e mostrar o progresso de um download atual.
NavigationProgress não será ativado em alguns casos, como quando o mesmo conteúdo é navegado, ou quando um fragmento de conteúdo é explorado em conteúdo atualmente carregado (ou seja, o valor da Content propriedade).
Ao navegar para um recurso XAML compilado, o evento final NavigationProgress pode não ser levantado. Isto significa que, no final do download, o último valor reportado BytesRead pode não ser igual ao MaxBytes valor. Trate do LoadCompleted evento para ser notificado quando a navegação terminar.
Note
Quando NavigationService eleva NavigationProgress, também eleva Application.NavigationProgress o evento no Application objeto.