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 régulièrement pendant un téléchargement pour fournir des informations de progression de 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é, 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 1024 octets de contenu téléchargé, et une fois de plus, si le nombre d’octets restants est jamais 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 redirigé vers 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 à avertir lorsque la navigation est terminée.
Note
Lorsque NavigationService le déclenchement est activé NavigationProgress, il déclenche Application.NavigationProgress également l’événement sur l’objet Application .
