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 、、 IsNavigationInitiatorNavigator 。

• 流覽內容： Uri 、 Content 。

• 流覽要求： WebRequest 。

• 流覽狀態： ExtraData 、、 TargetContentStateContentStateToSave 。

這項資訊可讓您評估流覽要求的本質，以及在流覽發生之前檢視和更新指定的要求詳細資料。

根據 所提供的 NavigatingCancelEventArgs 流覽要求資訊，或根據應用程式特定的狀態或程式碼，您可以將 屬性 true 設定為預設 (完全防止流覽 Cancel ， Cancel) false 。

屬性

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