NavigationService.Navigate メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したソース コンテンツに非同期的に移動します。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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
パラメーター
- 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
パラメーター
- 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 つのナビゲーション要求に固有のナビゲーション処理用のデータを渡すことができます。
次のイベント引数は、ナビゲーション状態へのアクセスを提供します。
ExtraData ( Navigating イベントに渡されます)。
ExtraData ( Navigated、 NavigationStopped、 LoadCompleted イベント ハンドラーに渡されます)。
こちらもご覧ください
適用対象
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
パラメーター
返品
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は、次の条件に該当する場合、rootで指定されたObjectに移動します。
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と同じ動作になります。