NavigatingCancelEventArgs 类

定义

命名空间:

System.Windows.Navigation

程序集:

PresentationFramework.dll

为 Navigating 事件提供数据。

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

public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs

type NavigatingCancelEventArgs = class
    inherit CancelEventArgs

Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

继承

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

示例

下面的示例演示如何处理 Navigating 以检测是否发出了刷新静态内容的请求，以及是否发出了刷新请求，以及如何取消请求。

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

注解

这些事件参数包含有关所请求的导航的信息，并传递给由以下实现的 Navigation 事件的处理程序：

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs 封装导航请求的以下详细信息：

• 导航启动： NavigationMode、 Navigator、 IsNavigationInitiator。

• 导航内容： Uri、 Content。

• 导航请求： WebRequest。

• 导航状态： ExtraData、 ContentStateToSave、 TargetContentState。

利用此信息，可以评估导航请求的性质，并在导航发生之前查看和更新指定的请求详细信息。

根据 提供的 NavigatingCancelEventArgs导航请求信息或应用程序特定的状态或代码，可以通过将 属性设置为 Canceltrue 默认 Cancelfalse (来完全阻止导航，) 。

属性

Cancel	获取或设置指示是否应取消事件的值。 (继承自 CancelEventArgs)
Content	获取对要导航到的内容对象的引用。
ContentStateToSave	获取或设置 CustomContentState 对象，该对象与正在从中导航的页面的后退导航历史记录项关联。
ExtraData	获取导航开始时传递的可选数据 Object。
IsNavigationInitiator	指示由 NavigationWindow 指定的导航器（Frame、Navigator）是否正在进行此导航，或者父导航器是否正在进行此操作。
NavigationMode	获取一个 NavigationMode 值，该值指示所发生导航的类型。
Navigator	引发此事件的导航器。
TargetContentState	获取要应用于所导航到的内容的 CustomContentState 对象。
Uri	获取要导航到的内容的统一资源标识符 (URI)。
WebRequest	获取用于请求指定内容的 WebRequest 对象。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• Navigating