NavigationService.NavigationProgress Evento

Definizione

Si verifica periodicamente durante un download per fornire informazioni sullo stato dello spostamento.

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 evento

Esempio

Nell'esempio seguente viene illustrato come gestire 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

Commenti

NavigationProgress viene passato un NavigationProgressEventArgs oggetto che espone le informazioni sullo stato di avanzamento seguenti:

  • Numero di byte scaricati finora (BytesRead).

  • Numero di byte totali da scaricare (MaxBytes).

NavigationProgress viene generato una volta per ogni 1024 byte di contenuto scaricato e ancora una volta se il numero di byte rimanenti è mai inferiore a 1024 byte. Per questo motivo, la gestione NavigationProgress offre un modo utile per tenere traccia e visualizzare lo stato di avanzamento di un download corrente.

NavigationProgress non verrà generato in alcuni casi, ad esempio quando si passa alla stessa parte di contenuto o quando si passa a un frammento di contenuto su contenuto attualmente caricato (ovvero il valore della Content proprietà).

Quando si passa a una risorsa XAML compilata, l'evento finale NavigationProgress potrebbe non essere generato. Ciò significa che alla fine del download, l'ultimo valore segnalato BytesRead potrebbe non essere uguale al MaxBytes valore. Gestire l'evento LoadCompleted per ricevere una notifica al termine della navigazione.

Nota

Quando NavigationService genera NavigationProgress, genera Application.NavigationProgress anche l'evento sull'oggetto Application .

Si applica a

Vedi anche