NavigatingCancelEventArgs Třída

Definice

Obor názvů:

System.Windows.Navigation

Sestavení:

PresentationFramework.dll

Poskytuje data pro navigaci událostí .

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

public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs

type NavigatingCancelEventArgs = class
    inherit CancelEventArgs

Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

Dědičnost

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Příklady

Následující příklad ukazuje, jak zpracovat Navigating , aby se zjistilo, jestli byl proveden požadavek na aktualizaci statického obsahu, a pokud ano, jak požadavek zrušit.

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

Poznámky

Tyto argumenty událostí obsahují informace o požadované navigaci a předávají se obslužným rutinám události Navigace , která je implementována následujícím kódem:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs zapouzdřuje následující podrobnosti požadavku na navigaci:

• Inicializace navigace: NavigationMode, Navigator, . IsNavigationInitiator

• Obsah navigace: Uri, Content.

• Požadavek na navigaci: WebRequest.

• Stav navigace: ExtraData, ContentStateToSave, TargetContentState.

Tyto informace vám umožní vyhodnotit povahu požadavku na navigaci a zobrazit a aktualizovat podrobnosti zadané žádosti před provedením navigace.

Na základě informací o požadavcích na navigaci poskytovaných službou NavigatingCancelEventArgsnebo na základě stavu nebo kódu specifického pro aplikaci můžete navigaci zcela zabránit nastavením Cancel vlastnosti na true (ve výchozím nastavení Cancel je false).

Vlastnosti

Cancel	Získá nebo nastaví hodnotu označující, zda má být událost zrušena. (Zděděno od CancelEventArgs)
Content	Získá odkaz na objekt obsahu, který je přecháděna.
ContentStateToSave	Získá nebo nastaví CustomContentState objekt, který je přidružen k položky historie zpětné navigace pro stránku, ze které procházíte.
ExtraData	Získá volitelná data Object , která byla předána při spuštění navigace.
IsNavigationInitiator	Určuje, jestli navigátor (NavigationWindow, Frame) určený parametrem Navigator obsluhuje tuto navigaci, nebo jestli to dělá nadřazený navigátor.
NavigationMode	NavigationMode Získá hodnotu, která označuje typ navigace, ke které dochází.
Navigator	Navigátor, který vyvolal tuto událost.
TargetContentState	CustomContentState Získá objekt, který se má použít na obsah, na který se přejde.
Uri	Získá identifikátor URI (Uniform Resource Identifier) pro obsah, na který se přejde.
WebRequest	WebRequest Získá objekt, který se používá k vyžádání zadaného obsahu.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Navigating