Page.NavigationService Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

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.

Ruft den Navigationsdienst ab, den der Host der Seite zum Verwalten der Navigation verwendet.

public:
 property System::Windows::Navigation::NavigationService ^ NavigationService { System::Windows::Navigation::NavigationService ^ get(); };

public System.Windows.Navigation.NavigationService NavigationService { get; }

member this.NavigationService : System.Windows.Navigation.NavigationService

Public ReadOnly Property NavigationService As NavigationService

Eigenschaftswert

NavigationService

Das NavigationService-Objekt, mit der Host der Seite die Navigation verwaltet, oder null, wenn der Host keine Navigation unterstützt.

Beispiele

Das folgende Beispiel zeigt, wie eine Seite überprüfen kann, ob ein Navigationsdienst verfügbar ist, und wenn ja, verwenden kann, um zurück zur vorherigen Seite zu navigieren.

public partial class HomePage : Page
{
    public HomePage()
    {
        InitializeComponent();

        // Don't allow back navigation if no navigation service
        if (this.NavigationService == null)
        {
            this.goBackButton.IsEnabled = false;
        }
    }

    void goBackButton_Click(object sender, RoutedEventArgs e)
    {
        // Go to previous entry in journal back stack
        if (this.NavigationService.CanGoBack)
        {
            this.NavigationService.GoBack();
        }
    }
}

Partial Public Class HomePage
    Inherits Page
    Public Sub New()
        InitializeComponent()

        ' Don't allow back navigation if no navigation service
        If Me.NavigationService Is Nothing Then
            Me.goBackButton.IsEnabled = False
        End If
    End Sub

    Private Sub goBackButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' Go to previous entry in journal back stack
        If Me.NavigationService.CanGoBack Then
            Me.NavigationService.GoBack()
        End If
    End Sub
End Class

Hinweise

Seiten können von mehreren Arten von Hosts gehostet werden, einschließlich Window, NavigationWindow, Frameund einem Browser.

Seiten müssen häufig in die Navigation ihres Hosts integriert werden, um die Navigation auf der Seite zu unterstützen. Da eine Seite jedoch möglicherweise nicht weiß, was ihr Host zur Laufzeit sein wird, kann sie dazu nicht direkt in die Navigationselemente ihres Hosts integriert werden.

Stattdessen kann versucht werden, einen Navigationsdienst zu verwenden, bei dem es sich um einen Dienst handelt, der browserbasierte Navigation unterstützt und von der NavigationService -Klasse gekapselt wird. Sie können jedoch keine eigene NavigationService Instanz erstellen. Stattdessen erstellen Hosttypen wie NavigationWindow, Frameoder ein Browser eine eigene NavigationService Instanz, auf die Sie über die NavigationService -Eigenschaft zugreifen können.

Der Navigationsdienst, der von der NavigationService -Eigenschaft zurückgegeben wird, ist die Instanz der -Klasse, die NavigationService vom ersten Navigator in der visuellen Struktur verwaltet wird. Wenn eine nicht gefunden wird, null wird zurückgegeben, was angibt, dass der Host einer Seite die Navigation nicht unterstützt.

Hinweis

Die Window -Klasse unterstützt keine Navigation und stellt keinen Navigationsdienst bereit.

Gilt für:

Freigeben über