NavigatingCancelEventArgs Klasse

Definition

Namespace:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Stellt Daten für das Navigating-Ereignis bereit.

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

public class NavigatingCancelEventArgs : System.ComponentModel.CancelEventArgs

type NavigatingCancelEventArgs = class
    inherit CancelEventArgs

Public Class NavigatingCancelEventArgs
Inherits CancelEventArgs

Vererbung

Object

EventArgs

CancelEventArgs

NavigatingCancelEventArgs

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie behandeln Navigating , um zu erkennen, ob eine Anforderung zum Aktualisieren von statischen Inhalten gestellt wurde, und, wenn dies dies war, wie die Anforderung abgebrochen wird.

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

Hinweise

Diese Ereignisargumente enthalten Informationen zur angeforderten Navigation und werden an Handler des Navigating-Ereignisses übergeben, das wie folgt implementiert wird:

• NavigationService.Navigating

• NavigationWindow.Navigating

• Frame.Navigating

• Application.Navigating

NavigatingCancelEventArgs kapselt die folgenden Details der Navigationsanforderung:

• Navigationsinitiierung: NavigationMode, Navigator, IsNavigationInitiator.

• Navigationsinhalt: Uri, Content.

• Navigationsanforderung: WebRequest.

• Navigationszustand: ExtraData, ContentStateToSave, TargetContentState.

Mit diesen Informationen können Sie sowohl die Art der Navigationsanforderung bewerten als auch die angegebenen Anforderungsdetails anzeigen und aktualisieren, bevor die Navigation erfolgt.

Basierend auf den Navigationsanforderungsinformationen, die von NavigatingCancelEventArgsbereitgestellt werden, oder basierend auf dem anwendungsspezifischen Zustand oder Code, können Sie die Navigation vollständig verhindern, indem Sie die Cancel -Eigenschaft auf true festlegen (standardmäßig Cancel ist false).

Eigenschaften

Cancel	Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest. (Geerbt von CancelEventArgs)
Content	Ruft einen Verweis auf das Inhaltsobjekt ab, zu dem navigiert wird.
ContentStateToSave	Ruft das CustomContentState-Objekt ab, das dem Eintrag im Navigationsverlauf zurück für die Seite zugeordnet ist, von der aus navigiert wird, oder legt dieses Objekt fest.
ExtraData	Ruft das optionale Daten-Object ab, das bei Beginn der Navigation übergeben wurde.
IsNavigationInitiator	Gibt an, ob der von NavigationWindow angegebene Navigator (Frame, Navigator) oder ein übergeordneter Navigator diese Navigation verarbeitet.
NavigationMode	Ruft einen NavigationMode-Wert ab, der den Typ der auftretenden Navigation angibt.
Navigator	Der Navigator, der dieses Ereignis ausgelöst hat.
TargetContentState	Ruft das CustomContentState-Objekt ab, das auf den Inhalt angewendet werden soll, zu dem navigiert wird.
Uri	Ruft den URI (Uniform Resource Identifier) für den Inhalt ab, zu dem navigiert wird.
WebRequest	Ruft das WebRequest-Objekt ab, das zum Anfordern des angegebenen Inhalts verwendet wird.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Navigating