NavigationService.Navigating Événement

Définition

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.

Navigating.

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 .

S’applique à

Voir aussi