Hyperlink.NavigateUri Properti

Definisi

Ruang nama:

System.Windows.Documents

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur URI untuk menavigasi ke saat Hyperlink diaktifkan.

public:
 property Uri ^ NavigateUri { Uri ^ get(); void set(Uri ^ value); };

[System.ComponentModel.Bindable(true)]
[System.Windows.Localizability(System.Windows.LocalizationCategory.Hyperlink)]
public Uri NavigateUri { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Hyperlink)>]
member this.NavigateUri : Uri with get, set

Public Property NavigateUri As Uri

Nilai Properti

Uri

URI yang akan dinavigasi saat Hyperlink diaktifkan. Default adalah null.

Atribut

BindableAttribute LocalizabilityAttribute

Contoh

Contoh berikut menunjukkan cara menggunakan NavigateUri atribut Hyperlink elemen .

<Paragraph>
  <Run>Text preceding the hyperlink.</Run>
  <Hyperlink
    NavigateUri="http://search.msn.com"
  >
    Link text.
  </Hyperlink>
  <Run Name="test">Text following the hyperlink.</Run>
</Paragraph>

Contoh berikut menunjukkan cara mengatur NavigateUri properti secara terprogram.

Paragraph parx = new Paragraph();
Run run1 = new Run("Text preceding the hyperlink.");
Run run2 = new Run("Text following the hyperlink.");
Run run3 = new Run("Link Text.");

Hyperlink hyperl = new Hyperlink(run3);
hyperl.NavigateUri = new Uri("http://search.msn.com");

parx.Inlines.Add(run1);
parx.Inlines.Add(hyperl);
parx.Inlines.Add(run2);

Dim parx As New Paragraph()
Dim run1 As New Run("Text preceeding the hyperlink.")
Dim run2 As New Run("Text following the hyperlink.")
Dim run3 As New Run("Link Text.")

Dim hyperl As New Hyperlink(run3)
hyperl.NavigateUri = New Uri("http://search.msn.com")

parx.Inlines.Add(run1)
parx.Inlines.Add(hyperl)
parx.Inlines.Add(run2)

Contoh berikut menunjukkan cara menggunakan mailto: pengidentifikasi sumber daya seragam (URI) untuk membuka jendela email baru yang berisi alamat email, alamat email, dan subjek, serta alamat email, subjek, dan isi.

<Hyperlink NavigateUri="mailto:username@domainname">mailto: With Email Address</Hyperlink>
<Hyperlink NavigateUri="mailto:username@domainname?subject=SubjectText">mailto: With Email Address and Subject</Hyperlink>
<Hyperlink NavigateUri="mailto:username@domainname?subject=SubjectText&body=BodyText">mailto: With Email Address, Subject, and Body</Hyperlink>

Keterangan

Untuk menautkan ke elemen sebaris tertentu, tentukan nama elemen yang didahului oleh simbol pagar (#).

Hyperlink dapat menavigasi ke nilai NavigateUri properti hanya jika induk langsung atau tidak langsung dari Hyperlink adalah host navigasi, termasuk NavigationWindow, Frame, atau browser apa pun yang dapat menghosting XBAP. Untuk informasi selengkapnya, lihat bagian Host Navigasi di Gambaran Umum Navigasi.

Saat pengguna mengarahkan mouse ke atas Hyperlink di XBAP, URI yang disimpan di NavigateUri properti ditampilkan di bilah status. Hyperlink menavigasi ke URI ini ketika pengguna mengklik Hyperlink. Jika nilai NavigateUri properti berubah setelah pengguna mengklik Hyperlink dan sebelum permintaan navigasi berikutnya, Hyperlink mengabaikan nilai NavigateUri baru properti dan menavigasi ke URI yang merupakan nilai NavigateUri properti saat pengguna mengklik Hyperlink.

Catatan

Anda tidak dibatasi untuk hanya menggunakan Hyperlink navigasi untuk melakukan. Anda juga dapat menggunakan NavigateUri properti terlampir, tetapi hanya dari berikut ini: FixedPage, , CanvasPath, dan Glyphs.

Informasi Properti Dependensi

Bidang pengidentifikasi	NavigateUriProperty
Properti metadata diatur ke true	Tidak ada