NavigationService.Navigating É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 quand une nouvelle navigation est demandée.
public:
event System::Windows::Navigation::NavigatingCancelEventHandler ^ Navigating;public event System.Windows.Navigation.NavigatingCancelEventHandler Navigating;member this.Navigating : System.Windows.Navigation.NavigatingCancelEventHandler Public Custom Event Navigating As NavigatingCancelEventHandler Type d'événement
Exemples
L’exemple suivant montre comment gérer Navigating pour détecter si une demande d’actualisation du contenu statique a été effectuée et, le cas échéant, pour annuler la demande.
void NavigationService_Navigating(object sender, NavigatingCancelEventArgs e)
{
// Don't allow refreshing of a static page
if ((e.NavigationMode == NavigationMode.Refresh) &&
(e.Uri.OriginalString == "StaticPage.xaml"))
{
e.Cancel = true;
}
}
Private Sub NavigationService_Navigating(ByVal sender As Object, ByVal e As NavigatingCancelEventArgs)
' Don't allow refreshing of a static page
If (e.NavigationMode = NavigationMode.Refresh) AndAlso (e.Uri.OriginalString = "StaticPage.xaml") Then
e.Cancel = True
End If
End Sub
Remarques
Navigating est déclenché lorsqu’une nouvelle navigation est demandée, mais avant que le contenu source ne soit demandé, notamment dans les cas suivants :
Navigate est appelée.
GoBack ou GoForward est appelé (ou une entrée est sélectionnée à partir d’une interface utilisateur de navigation).
Vous accédez à un fragment de contenu.
Vous gérez Navigating si vous avez besoin de découvrir des informations pertinentes concernant la demande de navigation avant le démarrage de la navigation. Ces informations sont disponibles à partir de l’objet NavigatingCancelEventArgs passé au gestionnaire d’événements Navigating .
Un WebRequest objet pour la navigation est créé et disponible à partir du NavigatingCancelEventArgs paramètre ; étant donné que la requête réelle n’a pas été effectuée à ce stade, vous pouvez reconfigurer l’objet WebRequest , si nécessaire.
Vous gérez NavigatingCancelEventArgs également l’annulation de la navigation, si nécessaire, en définissant sur Cancel true. Si vous annulez la navigation, aucun autre événement de navigation n’est déclenché.
Notes
Si votre application est hébergée dans le navigateur, vous ne pouvez pas empêcher l’utilisateur de s’éloigner de votre application en annulant l’événement Navigating .
Une fois que le navigateur a accédé au premier élément de contenu (NavigationWindow, Frame), chaque élément de contenu qui s’éloigne est ajouté à l’historique de navigation. Si vous avez besoin d’enregistrer des informations d’état sur le contenu à partir duquel vous naviguez, vous pouvez ajouter l’état à l’entrée de journal pour ce contenu en définissant ContentStateToSave avec un CustomContentState objet .
Notes
Lorsque NavigationService l’événement déclenche Navigating, il déclenche Application.Navigating également un événement sur l’objet Application .
