NavigationService.NavigationProgress Événement

  • Référence

Définition

Espace de noms:
System.Windows.Navigation
Assembly:
PresentationFramework.dll

Se produit périodiquement au cours d'un téléchargement, pour donner des informations sur la progression de la navigation.

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

Type d'événement

NavigationProgressEventHandler

Exemples

L’exemple suivant montre comment gérer 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

Remarques

NavigationProgress est passé à un NavigationProgressEventArgs qui expose les informations de progression suivantes :

  • Nombre d’octets téléchargés jusqu’à présent (BytesRead).

  • Nombre total d’octets à télécharger (MaxBytes).

NavigationProgress est déclenché une fois pour chaque 1 024 octets de contenu téléchargé, et une fois de plus si le nombre d’octets restants est toujours inférieur à 1 024 octets. Pour cette raison, la gestion NavigationProgress offre un moyen utile de suivre et d’afficher la progression d’un téléchargement actuel.

NavigationProgress ne sera pas déclenché dans certains cas, par exemple lorsque le même élément de contenu est accédé, ou lorsqu’un fragment de contenu est parcouru sur le contenu actuellement chargé (autrement dit, la valeur de la Content propriété ).

Lorsque vous accédez à une ressource XAML compilée, l’événement final NavigationProgress peut ne pas être déclenché. Cela signifie qu’à la fin du téléchargement, la dernière valeur signalée BytesRead peut ne pas être égale à la MaxBytes valeur. Gérez l’événement LoadCompleted pour être averti lorsque la navigation est terminée.

Notes

Lorsque NavigationService l’événement déclenche NavigationProgress, il déclenche Application.NavigationProgress également un événement sur l’objet Application .

S’applique à

Voir aussi