NavigatingCancelEventArgs Třída

Definice

Obor názvů:

System.Windows.Navigation

Sestavení:

PresentationFramework.dll

Poskytuje data pro událost navigace .

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 , jak zjistit, jestli byl proveden požadavek na aktualizaci statického obsahu, a pokud tomu tak bylo, jak žádost 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 jsou předány obslužným rutinám události navigace , která je implementována tímto:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs Zapouzdřuje následující podrobnosti o navigačním požadavku:

• Inicializace navigace: NavigationMode, Navigator, IsNavigationInitiator.

• Obsah navigace: Uri, Content.

• Žádost o navigaci: WebRequest.

• Stav navigace: ExtraData, ContentStateToSave, TargetContentState.

Tyto informace umožňují vyhodnotit povahu navigačního požadavku a zobrazit a aktualizovat zadané podrobnosti žádosti před přechodem.

Na základě informací o navigačním požadavku, které NavigatingCancelEventArgsposkytuje , nebo na základě stavu nebo kódu specifického pro aplikaci, můžete zcela zabránit navigaci nastavením Cancel vlastnosti na true (ve výchozím nastavení Cancel je false).

Vlastnosti

Name	Description
Content	Získá odkaz na objekt obsahu, který je přecházet na.
ContentStateToSave	Získá nebo nastaví CustomContentState objekt, který je přidružen k položky historie navigace zpět pro stránku, ze které se prochází.
ExtraData	Získá volitelná data Object , která byla předána při spuštění navigace.
IsNavigationInitiator	Určuje, zda je navigátor (NavigationWindow, Frame) určený obsluhou Navigator této navigace nebo zda nadřazený navigátor provádí.
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řechází.
Uri	Získá identifikátor URI (Uniform Resource Identifier) pro obsah, na který se prochází.
WebRequest	WebRequest Získá objekt, který se používá k vyžádání zadaného obsahu.

Viz také

• Navigating