NavigatingCancelEventArgs 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供 Navigating 事件的資料。
public ref class NavigatingCancelEventArgs : System::ComponentModel::CancelEventArgs
public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs
type NavigatingCancelEventArgs = class
inherit CancelEventArgs
Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs
- 繼承
範例
下列範例示範如何處理 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 事件的處理常式,由下列專案實作:
NavigatingCancelEventArgs 會封裝下列導覽要求的詳細資料:
流覽初始: NavigationMode 、、 IsNavigationInitiatorNavigator 。
流覽要求: 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) |