Condividi tramite


NavigationService.NavigationProgress Evento

Definizione

Si verifica periodicamente durante un download per fornire informazioni sullo stato di 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 oggetto NavigationProgressEventArgs 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 una volta di più se il numero di byte rimanenti è mai inferiore a 1024 byte. Per questo motivo, la gestione NavigationProgress fornisce 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 sul 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.

Annotazioni

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

Si applica a

Vedi anche