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を参照) を作成できます。

sourcenullされている場合、既存のコンテンツ (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は、次の条件に該当する場合、rootで指定されたObjectに移動します。

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

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

rootnullされている場合、既存のコンテンツ (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と同じ動作になります。

こちらもご覧ください

適用対象