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 的瀏覽器， (包括 Internet Explorer 6 和更新版本，以及 Firefox 2.0+) 。 如需詳細資訊，請參閱導覽概觀 中的流覽主機一節。

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

注意

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

相依性屬性資訊

識別碼欄位	NavigateUriProperty
設定為 的中繼資料屬性 true	無