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

注釈

これらのイベント引数には、要求されたナビゲーションに関する情報が含まれ、以下によって実装される Navigationing イベントのハンドラーに渡されます。

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs は、ナビゲーション要求の次の詳細をカプセル化します。

• ナビゲーションの開始: NavigationMode、、NavigatorIsNavigationInitiator。

• ナビゲーション コンテンツ: Uri、 Content。

• ナビゲーション要求: WebRequest。

• ナビゲーションの状態: ExtraData、、ContentStateToSaveTargetContentState。

この情報を使用すると、ナビゲーション要求の性質を評価し、ナビゲーションが発生する前に指定された要求の詳細を表示および更新できます。

によってNavigatingCancelEventArgs提供されるナビゲーション要求情報に基づいて、またはアプリケーション固有の状態またはコードに基づいて、 プロパティを にtrue設定することで、ナビゲーションをCancel完全に防止できます (既定では Cancel は falseです)。

プロパティ

Cancel	イベントをキャンセルするかどうかを示す値を取得または設定します。 (継承元 CancelEventArgs)
Content	移動先のコンテンツ オブジェクトへの参照を取得します。
ContentStateToSave	移動元のページの "戻る" ナビゲーション履歴エントリに関連付けられている CustomContentState オブジェクトを取得または設定します。
ExtraData	ナビゲーションが開始されたときに渡されたオプション データの Object を取得します。
IsNavigationInitiator	NavigationWindow によって指定されるナビゲーター (Frame、Navigator) がこのナビゲーションを処理しているのか、または親ナビゲーターが処理しているのかを示します。
NavigationMode	発生しているナビゲーションの種類を示す NavigationMode 値を取得します。
Navigator	このイベントを発生させたナビゲーター。
TargetContentState	移動先のコンテンツに適用される CustomContentState オブジェクトを取得します。
Uri	移動先のコンテンツの Uniform Resource Identifier (URI) を取得します。
WebRequest	指定したコンテンツを要求するために使用される WebRequest オブジェクトを取得します。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• Navigating