Hyperlink.NavigateUri 屬性

定義

命名空間:

System.Windows.Documents

組件:

PresentationFramework.dll

啟動時會取得或設定一個 URI，讓它導航到 Hyperlink 那裡。

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>

下列示範如何以程式設計的方式設定 Typography 屬性。

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： uniform resource identifier（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只有當 a Hyperlink 的直接或間接父節點是導航主機（包括 NavigationWindow、 Frame，或任何能承載 XBAP 的瀏覽器）時，才能導覽到屬性NavigateUri的值。 更多資訊請參閱 導航總覽中的導航主機章節。

當使用者將滑鼠移到XBAP中的a Hyperlink 上時，屬性中儲存 NavigateUri 的URI會顯示在狀態列中。 Hyperlink 當使用者點擊 Hyperlink. 如果NavigateUri屬性值在使用者點擊 後Hyperlink且在後續導覽請求前改變，Hyperlink則忽略該屬性的新值NavigateUri，並導向使用者點擊Hyperlink時該屬性的 NavigateUri URI 值。

備註

你不被限制只能用 Hyperlink to do 導航。 你也可以使用NavigateUri附加屬性，但只能從以下條件中取得：FixedPage、Path、 CanvasGlyphs和 。

相依財產資訊

項目	價值
識別碼欄位	NavigateUriProperty
元資料屬性設為 true	沒有