Language

NavigationService.Navigate メソッド

定義

指定したソース コンテンツに非同期的に移動します。

オーバーロード

名前 説明
Navigate(Uri, Object, Boolean)

URI にあるソース コンテンツに非同期的に移動し、ナビゲーション中に処理するためにナビゲーション状態を含むオブジェクトを渡し、コンテンツをサンドボックス化します。

Navigate(Uri, Object)

URI にあるソース コンテンツに非同期的に移動し、ナビゲーション中の処理に使用するデータを含むオブジェクトを渡します。

Navigate(Uri)

URI で指定されたコンテンツに非同期的に移動します。

Navigate(Object)

オブジェクトに含まれるコンテンツに非同期的に移動します。

Navigate(Object, Object)

オブジェクトに含まれるコンテンツに非同期的に移動し、ナビゲーション中の処理に使用するデータを含むオブジェクトを渡します。

Navigate(Uri, Object, Boolean)

URI にあるソース コンテンツに非同期的に移動し、ナビゲーション中に処理するためにナビゲーション状態を含むオブジェクトを渡し、コンテンツをサンドボックス化します。

public:
 bool Navigate(Uri ^ source, System::Object ^ navigationState, bool sandboxExternalContent);
public bool Navigate(Uri source, object navigationState, bool sandboxExternalContent);
member this.Navigate : Uri * obj * bool -> bool
Public Function Navigate (source As Uri, navigationState As Object, sandboxExternalContent As Boolean) As Boolean

パラメーター

source
Uri

目的のコンテンツの URI で初期化された Uri オブジェクト。

navigationState
Object

ナビゲーション中の処理に使用するデータを含むオブジェクト。

sandboxExternalContent
Boolean

部分信頼セキュリティ サンドボックスにコンテンツをダウンロードします ( true場合は、既定のインターネット ゾーンのアクセス許可セットを使用します)。 既定値は false です。

返品

true ナビゲーションが取り消されない場合。それ以外の場合は false。

注釈

このメソッドは、スタンドアロン アプリケーションと拡張アプリケーション マークアップ言語 (XAML) コンテンツ専用です。

このメソッドは、 NavigationService.Navigateと同じ動作を示し、ダウンロードされるコンテンツが部分信頼セキュリティ サンドボックスに配置されるようにすることで拡張します (既定のインターネット ゾーンのアクセス許可セットを使用します 。 WPF 部分信頼セキュリティを参照)。

こちらもご覧ください

適用対象

Navigate(Uri, Object)

URI にあるソース コンテンツに非同期的に移動し、ナビゲーション中の処理に使用するデータを含むオブジェクトを渡します。

public:
 bool Navigate(Uri ^ source, System::Object ^ navigationState);
public bool Navigate(Uri source, object navigationState);
member this.Navigate : Uri * obj -> bool
Public Function Navigate (source As Uri, navigationState As Object) As Boolean

パラメーター

source
Uri

目的のコンテンツの URI で初期化された Uri オブジェクト。

navigationState
Object

ナビゲーション中の処理に使用するデータを含むオブジェクト。

返品

true ナビゲーションが取り消されない場合。それ以外の場合は false。

例

次の例では、URI に移動し、ナビゲーション状態を渡す方法を示します。

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new Uri(this.addressTextBox.Text), DateTime.Now);
}
void NavigationService_LoadCompleted(object sender, NavigationEventArgs e)
{
    DateTime requestDateTime = (DateTime)e.ExtraData;
    string msg = string.Format("Request started {0}\nRequest completed {1}", requestDateTime, DateTime.Now);
    MessageBox.Show(msg);
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text), Date.Now)
End Sub
Private Sub NavigationService_LoadCompleted(ByVal sender As Object, ByVal e As NavigationEventArgs)
    Dim requestDateTime As Date = CDate(e.ExtraData)
    Dim msg As String = String.Format("Request started {0}" & vbLf & "Request completed {1}", requestDateTime, Date.Now)
    MessageBox.Show(msg)
End Sub

注釈

ナビゲーションは非同期であるため、複数のナビゲーションを同時に進行中にすることができます。 たとえば、1 つのページに 2 つの子フレームがある場合、両方のフレームが移動している可能性があります。 この場合、 NavigationService によって発生するさまざまなナビゲーション イベントは、移動するコンテンツごとに 1 つずつ複数回発生する可能性があり、ナビゲーションが要求された順序であるとは限りません。 そのため、特定のナビゲーション要求が個々の要求に固有のデータを処理する必要がある場合、すべてのナビゲーション要求で使用できるデータを使用することはできません。 代わりに、 navigationState を使用して、1 つのナビゲーション要求に固有のナビゲーション処理用のデータを渡すことができます。

次のイベント引数は、ナビゲーション状態へのアクセスを提供します。

こちらもご覧ください

適用対象

Navigate(Uri)

URI で指定されたコンテンツに非同期的に移動します。

public:
 bool Navigate(Uri ^ source);
public bool Navigate(Uri source);
member this.Navigate : Uri -> bool
Public Function Navigate (source As Uri) As Boolean

パラメーター

source
Uri

目的のコンテンツの URI で初期化された Uri オブジェクト。

返品

true ナビゲーションが取り消されない場合。それ以外の場合は false。

例

次の例は、URI に移動する方法を示しています。

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new Uri(this.addressTextBox.Text));
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New Uri(Me.addressTextBox.Text))
End Sub

注釈

sourceの値には、Web URL または有効なパック URI を指定できます (WPF のパック URI を参照)。

Navigate は、次の条件に該当する場合、 source で指定された URI に移動します。

  • Navigating イベントは取り消されません。

  • Web 要求 ( Navigatingを参照) を作成できます。

sourceがnullされている場合、既存のコンテンツ (Content) はクリアされます。

Note

Web コンテンツをダウンロードすると、Web 例外が発生する場合があります (例: 404: ファイルが見つかりません)。 このような例外は、 NavigationFailedから処理できます。

Navigateを使用してコンテンツ フラグメントに移動できます。 URI によって識別されるコンテンツが現在のコンテンツである場合、再びダウンロードされません。

こちらもご覧ください

適用対象

Navigate(Object)

オブジェクトに含まれるコンテンツに非同期的に移動します。

public:
 bool Navigate(System::Object ^ root);
public bool Navigate(object root);
member this.Navigate : obj -> bool
Public Function Navigate (root As Object) As Boolean

パラメーター

root
Object

移動するコンテンツを含むオブジェクト。

返品

true ナビゲーションが取り消されない場合。それ以外の場合は false。

例

次の例は、ソース コンテンツ ツリーを含む Page オブジェクトに移動する方法を示しています。

void goObjectButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new ContentPage());
}
Private Sub goObjectButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New ContentPage())
End Sub

注釈

Navigateは、次の条件に該当する場合、Objectで指定されたrootに移動します。

  • Navigating イベントは取り消されません。

  • Web 要求 ( Navigatingを参照) を作成できます。

rootがnullされている場合、既存のコンテンツ (Content) はクリアされます。

Note

Web コンテンツをダウンロードすると、Web 例外が発生する場合があります (例: 404: ファイルが見つかりません)。 このような例外は、 NavigationFailedから処理できます。

こちらもご覧ください

適用対象

Navigate(Object, Object)

オブジェクトに含まれるコンテンツに非同期的に移動し、ナビゲーション中の処理に使用するデータを含むオブジェクトを渡します。

public:
 bool Navigate(System::Object ^ root, System::Object ^ navigationState);
public bool Navigate(object root, object navigationState);
member this.Navigate : obj * obj -> bool
Public Function Navigate (root As Object, navigationState As Object) As Boolean

パラメーター

root
Object

移動するコンテンツを含むオブジェクト。

navigationState
Object

ナビゲーション中の処理に使用するデータを含むオブジェクト。

返品

true ナビゲーションが取り消されない場合。それ以外の場合は false。

例

次の例は、ソース コンテンツを含む Page オブジェクトに移動し、ナビゲーション状態を渡す方法を示しています。

void goButton_Click(object sender, RoutedEventArgs e)
{
    this.NavigationService.Navigate(new ContentPage(), DateTime.Now);
}
void NavigationService_LoadCompleted(object sender, NavigationEventArgs e)
{
    DateTime requestDateTime = (DateTime)e.ExtraData;
    string msg = string.Format("Request started {0}\nRequest completed {1}", requestDateTime, DateTime.Now);
    MessageBox.Show(msg);
}
Private Sub goButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Me.NavigationService.Navigate(New ContentPage(), Date.Now)
End Sub
Private Sub NavigationService_LoadCompleted(ByVal sender As Object, ByVal e As NavigationEventArgs)
    Dim requestDateTime As Date = CDate(e.ExtraData)
    Dim msg As String = String.Format("Request started {0}" & vbLf & "Request completed {1}", requestDateTime, Date.Now)
    MessageBox.Show(msg)
End Sub

注釈

このメソッドは、URI の代わりにオブジェクトが渡されますが、 NavigationService.Navigateと同じ動作になります。

こちらもご覧ください

適用対象