NavigatingCancelEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.
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:
NavigatingCancelEventArgs kapselt die folgenden Details der Navigationsanforderung:
Navigationsinitiierung: NavigationMode, Navigator, IsNavigationInitiator.
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) |