NavigationService.NavigationProgress Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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 .
