NavigationService.NavigationProgress Evento

Definición

Se produce periódicamente durante una descarga y ofrece información sobre el progreso de la exploración.

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

Ejemplos

En el ejemplo siguiente se muestra cómo controlar 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

Comentarios

NavigationProgress se pasa un objeto NavigationProgressEventArgs que expone la siguiente información de progreso:

  • Número de bytes descargados hasta ahora (BytesRead).

  • Número de bytes totales que se van a descargar (MaxBytes).

NavigationProgress se genera una vez por cada 1024 bytes de contenido descargado y una vez más si el número de bytes restantes es cada vez menor que 1024 bytes. Por este motivo, el control NavigationProgress proporciona una manera útil de realizar un seguimiento y mostrar el progreso de una descarga actual.

NavigationProgress no se generará en algunos casos, como cuando se navega a la misma parte de contenido, o cuando se navega a un fragmento de contenido en el contenido que está cargado actualmente (es decir, el valor de la Content propiedad).

Al navegar a un recurso XAML compilado, es posible que no se genere el evento final NavigationProgress . Esto significa que al final de la descarga, el último valor notificado BytesRead puede no ser igual al MaxBytes valor. Controle el LoadCompleted evento que se va a notificar cuando haya finalizado la navegación.

Nota:

Cuando NavigationService genera NavigationProgress, también genera Application.NavigationProgress un evento en el Application objeto .

Se aplica a

Consulte también