NavigationService.Navigate メソッド

定義

指定されたソース コンテンツに非同期に移動します。Navigate asynchronously to the specified source content.

オーバーロード

Navigate(Uri, Object, Boolean)

URI にあるソース コンテンツに非同期に移動して、ナビゲーション中の処理に使用するナビゲーションの状態を格納しているオブジェクトを渡し、コンテンツをサンドボックスに配置します。Navigate asynchronously to source content located at a URI, pass an object containing navigation state for processing during navigation, and sandbox the content.

Navigate(Uri, Object)

URI にあるソース コンテンツに非同期に移動して、ナビゲーション中の処理に使用するデータを格納しているオブジェクトを渡します。Navigate asynchronously to source content located at a URI, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri)

URI で指定されたコンテンツに非同期に移動します。Navigate asynchronously to content that is specified by a URI.

Navigate(Object)

オブジェクトに格納されているコンテンツに非同期に移動します。Navigate asynchronously to content that is contained by an object.

Navigate(Object, Object)

オブジェクトに格納されているコンテンツに非同期に移動して、ナビゲーション中の処理に使用するデータを格納しているオブジェクトを渡します。Navigate asynchronously to content that is contained by an object, and pass an object that contains data to be used for processing during navigation.

Navigate(Uri, Object, Boolean)

URI にあるソース コンテンツに非同期に移動して、ナビゲーション中の処理に使用するナビゲーションの状態を格納しているオブジェクトを渡し、コンテンツをサンドボックスに配置します。Navigate asynchronously to source content located at a URI, pass an object containing navigation state for processing during navigation, and sandbox the content.

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 オブジェクト。A Uri object initialized with the URI for the desired content.

navigationState
Object

ナビゲーション中の処理に使用するデータを格納しているオブジェクト。An object that contains data to be used for processing during navigation.

sandboxExternalContent
Boolean

コンテンツを (既定のインターネット ゾーン アクセス許可が設定された) 部分信頼セキュリティ サンドボックスにダウンロードする場合は trueDownload content into a partial trust security sandbox (with the default Internet zone set of permissions, if true. 既定値は、false です。The default is false.

戻り値

ナビゲーションがキャンセルされない場合は true。それ以外の場合は falsetrue if a navigation is not canceled; otherwise, false.

注釈

このメソッドは、スタンドアロンアプリケーションと Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) コンテンツに対してのみ使用されます。This method is only for standalone applications and Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) content.

このメソッドは NavigationService.Navigateと同じ動作をし、ダウンロードされるコンテンツが部分信頼セキュリティサンドボックスに配置されるようにします (既定のインターネットゾーンのアクセス許可セットを使用します。「 WPF 部分信頼セキュリティ」を参照してください)。This method exhibits the same behavior as NavigationService.Navigate, and extends it by ensuring that the content that is being downloaded is placed into a partial trust security sandbox (with the default Internet zone set of permissions - see WPF Partial Trust Security).

こちらもご覧ください

Navigate(Uri, Object)

URI にあるソース コンテンツに非同期に移動して、ナビゲーション中の処理に使用するデータを格納しているオブジェクトを渡します。Navigate asynchronously to source content located at a URI, and pass an object that contains data to be used for processing during navigation.

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 オブジェクト。A Uri object initialized with the URI for the desired content.

navigationState
Object

ナビゲーション中の処理に使用するデータを格納しているオブジェクト。An object that contains data to be used for processing during navigation.

戻り値

ナビゲーションがキャンセルされない場合は true。それ以外の場合は falsetrue if a navigation is not canceled; otherwise, false.

次の例は、URI への移動とナビゲーション状態の受け渡しを示しています。The following example demonstrates navigating to a URI and passing navigation state.

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

注釈

ナビゲーションは非同期であるため、複数のナビゲーションを同時に実行することができます。Since navigations are asynchronous, it is possible for multiple navigations to be in progress at the same time. たとえば、1つのページに2つの子フレームがある場合、両方のフレームが移動している可能性があります。For example, if there are two child frames on a single page, both frames could be navigating. この場合、NavigationService によって発生したさまざまなナビゲーションイベントが複数回発生する可能性があり、移動先のコンテンツごとに1つずつ、ナビゲーションが要求された順序ではありません。In this case, the various navigation events that are raised by NavigationService may be raised multiple times, one for each piece of content that is being navigated to, and not necessarily in order that the navigations were requested. そのため、特定のナビゲーション要求が個々の要求に固有のデータを処理する必要がある場合、すべてのナビゲーション要求で使用可能なデータを使用することはできません。Consequently, if a particular navigation request needs to process data that is specific to the individual request, it cannot use data that is available to all navigation requests. 代わりに、navigationState を使用して、1つのナビゲーション要求に固有のナビゲーション処理にデータを渡すことができます。Instead, you can use navigationState to pass data for navigation processing that is specific to one navigation request.

次のイベント引数を使用すると、ナビゲーション状態にアクセスできます。The following event arguments provide access to navigation state:

こちらもご覧ください

Navigate(Uri)

URI で指定されたコンテンツに非同期に移動します。Navigate asynchronously to content that is specified by a 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 オブジェクト。A Uri object initialized with the URI for the desired content.

戻り値

ナビゲーションがキャンセルされない場合は true。それ以外の場合は falsetrue if a navigation is not canceled; otherwise, false.

次の例は、URI に移動する方法を示しています。The following example shows how to navigate to a 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 URLURL または有効なパック URI (「 WPF のパック uri」を参照) を指定できます。The value of source can be a Web URLURL or a valid pack URI (see Pack URIs in WPF).

次の条件に該当する場合、Navigatesource で指定された URI に移動します。Navigate will navigate to the URI specified by source if the following conditions are true:

  • Navigating イベントは取り消されません。The Navigating event is not cancelled.

  • Web 要求 (「Navigating」を参照) を作成できます。A web request (see Navigating) can be created.

sourcenull場合、既存のコンテンツ (Content) はクリアされます。If source is null, the existing content (Content) is cleared.

注意

Web コンテンツをダウンロードするときに、Web 例外が発生する場合があります (たとえば、404: ファイルが見つかりません)。When downloading Web content, you may receive a Web exception (for example, 404: File Not Found). このような例外は、NavigationFailedで処理できます。You can handle such exceptions from NavigationFailed.

コンテンツフラグメントに移動するには、Navigate を使用します。You can use Navigate to navigate to a content fragment. URI で識別されるコンテンツが現在のコンテンツである場合は、再度ダウンロードされません。If the content identified by the URI is the current content, it is not downloaded again.

こちらもご覧ください

Navigate(Object)

オブジェクトに格納されているコンテンツに非同期に移動します。Navigate asynchronously to content that is contained by an 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

移動先のコンテンツを格納しているオブジェクト。An object that contains the content to navigate to.

戻り値

ナビゲーションがキャンセルされない場合は true。それ以外の場合は falsetrue if a navigation is not canceled; otherwise, false.

次の例は、ソースコンテンツツリーを含む Page オブジェクトに移動する方法を示しています。The following example shows how to navigate to a Page object containing the source content tree.

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

注釈

次の条件に該当する場合、Navigateroot によって指定された Object に移動します。Navigate will navigate to the Object specified by root if the following conditions are true:

  • Navigating イベントは取り消されません。The Navigating event is not cancelled.

  • Web 要求 (「Navigating」を参照) を作成できます。A web request (see Navigating) can be created.

rootnull場合、既存のコンテンツ (Content) はクリアされます。If root is null, the existing content (Content) is cleared.

注意

Web コンテンツをダウンロードするときに、Web 例外が発生する場合があります (たとえば、404: ファイルが見つかりません)。When downloading Web content, you may receive a Web exception (for example, 404: File Not Found). このような例外は、NavigationFailedで処理できます。You can handle such exceptions from NavigationFailed.

こちらもご覧ください

Navigate(Object, Object)

オブジェクトに格納されているコンテンツに非同期に移動して、ナビゲーション中の処理に使用するデータを格納しているオブジェクトを渡します。Navigate asynchronously to content that is contained by an object, and pass an object that contains data to be used for processing during navigation.

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

移動先のコンテンツを格納しているオブジェクト。An object that contains the content to navigate to.

navigationState
Object

ナビゲーション中の処理に使用するデータを格納しているオブジェクト。An object that contains data to be used for processing during navigation.

戻り値

ナビゲーションがキャンセルされない場合は true。それ以外の場合は falsetrue if a navigation is not canceled; otherwise, false.

次の例は、ソースコンテンツを含む Page オブジェクトに移動し、ナビゲーション状態を渡す方法を示しています。The following example shows how to navigate to a Page object containing the source content, and passing navigation state.

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

注釈

このメソッドの動作は NavigationService.Navigateと同じですが、URI ではなくオブジェクトが渡されます。This method has the same behavior as NavigationService.Navigate, although an object is passed instead of a URI.

こちらもご覧ください

適用対象