NavigatingCancelEventArgs NavigatingCancelEventArgs NavigatingCancelEventArgs NavigatingCancelEventArgs Class


Navigating イベントにデータを提供します。Provides data for the Navigating event.

public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs
public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs
type NavigatingCancelEventArgs = class
    inherit CancelEventArgs
Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

次の例は、処理する方法を示しています。Navigatingおよび 1 つが、要求をキャンセルする方法を静的なコンテンツを更新する要求が行われたかどうかを検出します。The following example shows how to handle Navigating to detect whether a request to refresh static content was made, and if one was, how to cancel the request.


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


これらのイベント引数には、要求され、のハンドラーに渡されるナビゲーションに関する情報が含まれて、 Navigatingイベントで、次によって実装されます。These event arguments contain information about the navigation that was requested, and are passed to handlers of the Navigating event, which is implemented by the following:

NavigatingCancelEventArgs ナビゲーション要求の次の詳細をカプセル化します。NavigatingCancelEventArgs encapsulates the following details of the navigation request:

この情報を使用すると、ナビゲーション要求の性質を評価し、表示し、ナビゲーションが発生する前に、指定された要求の詳細を更新できます。This information allows you to both evaluate the nature of the navigation request, and view and update specified request details before navigation occurs.

によって提供される、ナビゲーション要求の情報に基づくNavigatingCancelEventArgs、またはアプリケーション固有の状態またはコードに基づく、完全に回避できますナビゲーションを設定して、Cancelプロパティをtrue(既定では、Cancelfalse).Based on the navigation request information provided by NavigatingCancelEventArgs, or based on application-specific state or code, you can completely prevent navigation by setting the Cancel property to true (by default, Cancel is false).


Cancel Cancel Cancel Cancel

イベントをキャンセルするかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
Content Content Content Content

移動先のコンテンツ オブジェクトへの参照を取得します。Gets a reference to the content object that is being navigated to.

ContentStateToSave ContentStateToSave ContentStateToSave ContentStateToSave

移動元のページの "戻る" ナビゲーション履歴エントリに関連付けられている CustomContentState オブジェクトを取得または設定します。Gets or sets the CustomContentState object that is associated with the back navigation history entry for the page being navigated from.

ExtraData ExtraData ExtraData ExtraData

ナビゲーションが開始されたときに渡されたオプション データの Object を取得します。Gets the optional data Object that was passed when navigation started.

IsNavigationInitiator IsNavigationInitiator IsNavigationInitiator IsNavigationInitiator

NavigationWindow によって指定されるナビゲーター (FrameNavigator) がこのナビゲーションを処理しているのか、または親ナビゲーターが処理しているのかを示します。Indicates whether the navigator (NavigationWindow, Frame) that is specified by Navigator is servicing this navigation, or whether a parent navigator is doing so.

NavigationMode NavigationMode NavigationMode NavigationMode

発生しているナビゲーションの種類を示す NavigationMode 値を取得します。Gets a NavigationMode value that indicates the type of navigation that is occurring.

Navigator Navigator Navigator Navigator

このイベントを発生させたナビゲーター。The navigator that raised this event.

TargetContentState TargetContentState TargetContentState TargetContentState

移動先のコンテンツに適用される CustomContentState オブジェクトを取得します。Gets the CustomContentState object that is to be applied to the content being navigated to.

Uri Uri Uri Uri

移動先のコンテンツの Uniform Resource Identifier (URI)uniform resource identifier (URI) を取得します。Gets the Uniform Resource Identifier (URI)uniform resource identifier (URI) for the content being navigated to.

WebRequest WebRequest WebRequest WebRequest

指定したコンテンツを要求するために使用される WebRequest オブジェクトを取得します。Gets the WebRequest object that is used to request the specified content.


Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)