Hyperlink.NavigateUri プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
public:
property Uri ^ NavigateUri { Uri ^ get(); void set(Uri ^ value); };Uri NavigateUri();
void NavigateUri(Uri value);public System.Uri NavigateUri { get; set; }var uri = hyperlink.navigateUri;
hyperlink.navigateUri = uri;Public Property NavigateUri As Uri<Hyperlink NavigateUri="uriString"/>
プロパティ値
ハイパーリンクがアクティブ化されたときに移動する Uniform Resource Identifier (URI)。 既定値は null です。
注釈
既定では、 ハイパーリンク はテキスト ハイパーリンクとして表示されます。 ユーザーがクリックすると、既定のブラウザーの NavigateUri プロパティで指定した URI が開きます。 (具体的には、NavigateUri 値で指定した特定のスキーム/プロトコルに登録されているアプリで起動します)。既定のブラウザーは、アプリとは別のプロセスです。 一般的なユーザー エクスペリエンスは、新しいブラウザー アプリがアプリの横に分割ウィンドウとして表示され、ブラウザーがフォーカスを取得することです。
NavigateUri の値を指定するときにナビゲーションを発生させるために Click イベントを処理する必要はありません。 Click イベントは、新しいアプリ ページを読み込む場合など、アプリ内のナビゲーションを目的としており、そのシナリオでは NavigateUri 値は必要ありません。 また、既定のブラウザーで NavigateUri に指定された有効なターゲットが読み込まれるのを防ぐために 、Click イベント ハンドラー内でできることは何もありません。このアクションは、ハイパーリンクがアクティブ化されたときに自動的に (非同期的に) 実行され、 Click イベント ハンドラー内から取り消すことはできません。
ハイパーリンクが、アプリの一部でもある WebView コントロール内に指定された URI を読み込む必要がある場合は、NavigateUri の値を指定しないでください。 代わりに Click イベントを処理し、読み込む URI を指定して WebView.Navigate を呼び出します。
http: または https: スキームを使用する必要はありません。 ブラウザーに読み込むのに適したリソース コンテンツがこれらの場所にある場合は、ms-appx:、ms-appdata:、または ms-resources: などのスキームを使うことができます。 ただし、file: スキームは明確に禁止されます。 詳しくは、「URI スキーム」 をご覧ください。