NavigatingCancelEventArgs Classe

Définition

Espace de noms:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Fournit des données pour l’événement Navigation .

public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs

public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs

type NavigatingCancelEventArgs = class
    inherit CancelEventArgs

Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

Héritage

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Exemples

L’exemple suivant montre comment gérer Navigating la façon de détecter si une demande d’actualisation du contenu statique a été effectuée et, le cas échéant, comment 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

Ces arguments d’événement contiennent des informations sur la navigation demandée et sont passés aux gestionnaires de l’événement Navigation , qui est implémenté par les éléments suivants :

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs encapsule les détails suivants de la demande de navigation :

• Initiation de navigation : NavigationMode, Navigator, IsNavigationInitiator.

• Contenu de navigation : Uri, Content.

• Demande de navigation : WebRequest.

• État de navigation : ExtraData, ContentStateToSave, TargetContentState.

Ces informations vous permettent d’évaluer à la fois la nature de la demande de navigation et d’afficher et de mettre à jour les détails de la demande spécifié avant la navigation.

En fonction des informations de demande de navigation fournies par NavigatingCancelEventArgs, ou en fonction de l’état ou du code spécifique à l’application, vous pouvez empêcher complètement la navigation en définissant la Cancel propriété true sur (par défaut, Cancel est false).

Propriétés

Nom	Description
Content	Obtient une référence à l’objet de contenu en cours d’accès.
ContentStateToSave	Obtient ou définit l’objet CustomContentState associé à l’entrée d’historique de navigation arrière de la page à partir de laquelle vous accédez.
ExtraData	Obtient les données Object facultatives qui ont été passées lors du démarrage de la navigation.
IsNavigationInitiator	Indique si le navigateur (NavigationWindow, Frame) spécifié par Navigator la maintenance de cette navigation ou si un navigateur parent le fait.
NavigationMode	Obtient une NavigationMode valeur qui indique le type de navigation qui se produit.
Navigator	Navigateur qui a déclenché cet événement.
TargetContentState	Obtient l’objet CustomContentState à appliquer au contenu auquel accéder.
Uri	Obtient l’URI (Uniform Resource Identifier) pour le contenu à accéder.
WebRequest	Obtient l’objet WebRequest utilisé pour demander le contenu spécifié.

Voir aussi

• Navigating