Hyperlink.NavigateUri Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Documents

Mendapatkan atau mengatur Pengidentifikasi Sumber Daya Seragam (URI) untuk menavigasi saat Hyperlink diaktifkan.

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"/>

Nilai Properti

Uri Uri

Pengidentifikasi Sumber Daya Seragam (URI) untuk menavigasi ke saat Hyperlink diaktifkan. Defaultnya adalah null.

Keterangan

Secara default, Hyperlink muncul sebagai hyperlink teks. Saat pengguna mengkliknya, pengguna akan membuka URI yang Anda tentukan di properti NavigateUri di browser default. (Lebih khusus lagi, ini diluncurkan di aplikasi yang terdaftar untuk skema/protokol tertentu seperti yang Anda tentukan dalam nilai NavigateUri.) Browser default adalah proses terpisah dari aplikasi Anda. Pengalaman pengguna yang khas adalah bahwa aplikasi browser baru muncul sebagai panel terpisah bersama aplikasi Anda, dan browser mendapatkan fokus.

Anda tidak perlu menangani peristiwa Klik untuk menyebabkan navigasi saat Anda menentukan nilai untuk NavigateUri. Peristiwa Klik ditujukan untuk navigasi dalam aplikasi, misalnya jika Anda ingin halaman aplikasi baru dimuat, dan untuk skenario tersebut Anda tidak memerlukan nilai NavigateUri. Tidak ada juga yang dapat Anda lakukan dalam penanganan aktivitas Klik untuk mencegah browser default memuat target valid yang ditentukan untuk NavigateUri; tindakan tersebut terjadi secara otomatis (secara asinkron) saat hyperlink diaktifkan dan tidak dapat dibatalkan dari dalam penanganan aktivitas Klik .

Jika niat Anda adalah bahwa Hyperlink harus memuat URI tertentu dalam kontrol WebView yang juga merupakan bagian dari aplikasi Anda, maka jangan tentukan nilai untuk NavigateUri. Tangani peristiwa Klik sebagai gantinya, dan panggil WebView.Navigate, yang menentukan URI yang akan dimuat.

Anda tidak perlu menggunakan skema http: atau https: . Anda dapat menggunakan skema seperti ms-appx:, ms-appdata:, atau ms-resources:, jika ada konten sumber daya di lokasi ini yang sesuai untuk dimuat di browser. Namun, file: skema secara khusus diblokir. Untuk informasi selengkapnya, lihat skema URI.

Lihat juga

• Click