NavigatingCancelEventArgs Classe

Définition

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
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 :

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

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)

S’applique à

Voir aussi