NavigatingCancelEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Windows.Navigation

Zestaw:

PresentationFramework.dll

Udostępnia dane dla zdarzenia nawigowania .

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

public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs

type NavigatingCancelEventArgs = class
    inherit CancelEventArgs

Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

Dziedziczenie

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Przykłady

W poniższym przykładzie pokazano, jak obsługiwać Navigating wykrywanie, czy zostało wykonane żądanie odświeżenia zawartości statycznej, a jeśli tak było, jak anulować żądanie.

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

Uwagi

Te argumenty zdarzeń zawierają informacje o żądanej nawigacji i są przekazywane do procedur obsługi zdarzenia nawigowania , które jest implementowane przez następujące elementy:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs hermetyzuje następujące szczegóły żądania nawigacji:

• Inicjowanie nawigacji: NavigationMode, Navigator, IsNavigationInitiator.

• Zawartość nawigacji: Uri, Content.

• Żądanie nawigacji: WebRequest.

• Stan nawigacji: ExtraData, ContentStateToSave, TargetContentState.

Te informacje umożliwiają zarówno ocenę charakteru żądania nawigacji, jak i wyświetlenie i zaktualizowanie określonych szczegółów żądania przed rozpoczęciem nawigacji.

Na podstawie informacji o żądaniu nawigacji dostarczonych przez NavigatingCancelEventArgsprogram lub na podstawie stanu lub kodu specyficznego dla aplikacji można całkowicie zapobiec nawigacji, ustawiając Cancel właściwość na true wartość (domyślnie Cancel jest to false).

Właściwości

Cancel	Pobiera lub ustawia wartość wskazującą, czy zdarzenie powinno zostać anulowane. (Odziedziczone po CancelEventArgs)
Content	Pobiera odwołanie do obiektu zawartości, do którego jest przenoszony.
ContentStateToSave	Pobiera lub ustawia CustomContentState obiekt skojarzony z wpisem historii nawigacji wstecz dla strony, z którą jest nawigowana.
ExtraData	Pobiera opcjonalne dane Object , które zostały przekazane podczas uruchamiania nawigacji.
IsNavigationInitiator	Wskazuje, czy nawigator (NavigationWindow, Frame) określony przez Navigator usługę obsługuje tę nawigację, czy też czy nawigator nadrzędny to robi.
NavigationMode	Pobiera wartość wskazującą NavigationMode typ nawigacji, która występuje.
Navigator	Nawigator, który podniósł to zdarzenie.
TargetContentState	CustomContentState Pobiera obiekt, do którego ma zostać zastosowana zawartość, do którą przechodzi.
Uri	Pobiera jednolity identyfikator zasobu (URI) dla zawartości, do których jest przechodzina.
WebRequest	WebRequest Pobiera obiekt używany do żądania określonej zawartości.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Navigating