NavigatingCancelEventArgs Classe

Définition

Espace de noms:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

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

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 pour 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 transmis 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 à la navigation : NavigationMode, Navigator, IsNavigationInitiator.

• Contenu de navigation : Uri, Content.

• Demande de navigation : WebRequest.

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

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

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

Propriétés

Cancel	Obtient ou définit une valeur indiquant si l'événement doit être annulé. (Hérité de CancelEventArgs)
Content	Obtient une référence à l'objet de contenu cible de la navigation.
ContentStateToSave	Obtient ou définit l’objet CustomContentState associé à l’entrée de l’historique de navigation arrière pour la page source de la navigation.
ExtraData	Obtient l'Object de données facultatif passé lorsque la navigation a commencé.
IsNavigationInitiator	Indique si le navigateur (NavigationWindow, Frame) spécifié par Navigator entretient cette navigation ou si c'est un navigateur parent qui opère.
NavigationMode	Obtient une valeur NavigationMode qui indique le type de navigation en cours.
Navigator	Navigateur qui a déclenché l'événement.
TargetContentState	Obtient l'objet CustomContentState à appliquer au contenu cible de navigation.
Uri	Obtient l’URI (Uniform Resource Identifier) pour le contenu cible de la navigation.
WebRequest	Obtient l'objet WebRequest utilisé pour effectuer une requête sur le contenu spécifié.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Navigating