Page.NavigationService プロパティ

定義

名前空間:

System.Windows.Controls

アセンブリ:

PresentationFramework.dll

ページのホストがナビゲーションの管理のために使用しているナビゲーション サービスを取得します。

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

プロパティ値

NavigationService

ページのホストがナビゲーションの管理のために使用している NavigationService オブジェクト。ホストがナビゲーションをサポートしない場合は null。

例

次の例は、ページでナビゲーション サービスが使用可能かどうかを確認する方法を示しています。その場合は、それを使用して前のページに戻ります。

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

注釈

ページは、複数の種類のホスト (、、NavigationWindow、FrameブラウザーなどWindow) でホストできます。

多くの場合、ページ内ナビゲーションサポートを提供するには、ページをホストのナビゲーションと統合する必要があります。 ただし、ページは実行時にホストが何であるかを知らない可能性があるため、ホストのナビゲーション メンバーと直接統合することはできません。

代わりに、ブラウザースタイルのナビゲーションをサポートし、クラスによってカプセル化されるサービスであるナビゲーション サービスの使用を NavigationService 試みることができます。 ただし、独自 NavigationService のインスタンスを作成することはできません。 代わりに、ホストの種類 (、FrameまたはブラウザーなどNavigationWindow) によって、プロパティからアクセスできる独自NavigationServiceのインスタンスがNavigationService作成されます。

プロパティから NavigationService 返されるナビゲーション サービスは、ビジュアル ツリー上 NavigationService の最初のナビゲーターによって管理されるクラスのインスタンスです。 見つからない場合は、 null ページのホストがナビゲーションをサポートしていないことを示す返されます。

注意

クラスは Window ナビゲーションをサポートせず、ナビゲーション サービスも提供しません。