Freigeben über


NavigationService.Navigating Ereignis

Definition

Tritt ein, wenn eine neue Navigation angefordert wird.

public:
 event System::Windows::Navigation::NavigatingCancelEventHandler ^ Navigating;
public event System.Windows.Navigation.NavigatingCancelEventHandler Navigating;
member this.Navigating : System.Windows.Navigation.NavigatingCancelEventHandler 
Public Custom Event Navigating As NavigatingCancelEventHandler 

Ereignistyp

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie behandeln Navigating , um zu erkennen, ob eine Anforderung zum Aktualisieren statischer Inhalte gestellt wurde, und wenn ja, die Anforderung abzubrechen.

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

Navigating wird ausgelöst, wenn eine neue Navigation angefordert wird, aber bevor der Quellinhalt angefordert wird, einschließlich:

  • Navigate wird aufgerufen.

  • GoBack oder GoForward wird aufgerufen (oder ein Eintrag wird auf einer Navigationsoberfläche ausgewählt).

  • Zu einem Inhaltsfragment wird navigiert.

Sie behandeln Navigating , wenn Sie relevante Informationen zur Navigationsanforderung ermitteln müssen, bevor die Navigation gestartet wird. Diese Informationen sind über das NavigatingCancelEventArgs -Objekt verfügbar, das an den Navigating Ereignishandler übergeben wird.

Ein WebRequest Objekt für die Navigation wird erstellt und über den NavigatingCancelEventArgs Parameter verfügbar. Da die tatsächliche Anforderung zu diesem Zeitpunkt noch nicht gestellt wurde, können Sie das WebRequest Objekt bei Bedarf neu konfigurieren.

Sie können NavigatingCancelEventArgs die Navigation bei Bedarf auch abbrechen, indem Sie auf true festlegen Cancel . Wenn Sie die Navigation abbrechen, werden keine anderen Navigationsereignisse ausgelöst.

Hinweis

Wenn Ihre Anwendung im Browser gehostet wird, können Sie den Benutzer nicht daran hindern, von Ihrer Anwendung wegzu navigieren, indem Sie das Navigating Ereignis abbrechen.

Nachdem der erste Inhaltsabschnitt von einem Navigator (NavigationWindow, ) zu navigiert wurde, Framewird jeder Teil des Inhalts, von dem weg navigiert wird, dem Navigationsverlauf hinzugefügt. Wenn Sie Zustandsinformationen zu den Inhalten speichern müssen, von denen Sie weg navigieren, können Sie den Zustand dem Journaleintrag für diesen Inhalt hinzufügen, indem Sie mit einem CustomContentState -Objekt festlegenContentStateToSave.

Hinweis

Wenn NavigationService ausgelöst wirdNavigating, wird auch das -Ereignis für das Application -Objekt ausgelöstApplication.Navigating.

Gilt für:

Weitere Informationen