Hyperlink.NavigateUri 屬性

定義

命名空間:

System.Windows.Documents

組件:

PresentationFramework.dll

取得或設定啟動 Hyperlink 時要所要巡覽的 URI。

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

屬性值

Uri

啟用 時要巡覽至的 Hyperlink URI。 預設為 null。

屬性

BindableAttribute LocalizabilityAttribute

範例

下列範例示範如何使用 NavigateUri 項目的 屬性 Hyperlink 。

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

下列範例示範如何以程序設計方式設定 NavigateUri 屬性。

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)

下列範例示範如何使用 mailto： 統一資源標識碼 (URI) 開啟新的郵件視窗，其中包含電子郵件地址、電子郵件地址和主旨，以及電子郵件位址、主旨和本文。

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

備註

若要連結至特定的內嵌專案，請指定專案名稱前面加上井字元號 (#) 。

Hyperlink只有在的直接或間接父Hyperlink代是導覽主機時，才能巡覽至 屬性的值NavigateUri，包括 NavigationWindow、 Frame或任何可裝載 XBAP 的瀏覽器。 如需詳細資訊，請參閱 導覽概觀中的導覽主機一節。

當使用者將滑鼠停留在 XBAP 中的 上方 Hyperlink 時，儲存在 屬性中的 NavigateUri URI 會顯示在狀態列中。 Hyperlink 當使用者按兩下 Hyperlink時，會巡覽至此URI。 如果使用者按兩下之後和後續導覽要求之前變更屬性的值NavigateUri，Hyperlink則會忽略屬性的新值NavigateUri，並在使用者按兩下Hyperlink時巡覽至屬性值的URINavigateUri。Hyperlink

注意

您不限於只使用 Hyperlink 進行導覽。 您也可以使用附加屬性，但只能從下列專案使用 NavigateUri ： FixedPage、 Path、 Canvas和 Glyphs。

相依性屬性資訊

標識元欄位	NavigateUriProperty
設定為的元數據屬性 true	無