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级是导航主机（包括 NavigationWindow、 Frame或可以托管 XBAP 的任何浏览器）时，才能导航到 属性的值NavigateUri。 有关详细信息，请参阅导航 概述中的导航主机部分。

当用户将鼠标悬停在 XBAP 中的 上 Hyperlink 时，存储在 属性中的 NavigateUri URI 将显示在状态栏中。 Hyperlink 当用户单击 Hyperlink时导航到此 URI。 如果用户在后续导航请求之前单击 Hyperlink 和 后， 属性的值NavigateUri发生了更改，Hyperlink则忽略 属性的新值NavigateUri，并在用户单击 Hyperlink时导航到作为 属性值的 NavigateUri URI。

注意

不限制为仅使用 Hyperlink 以执行导航。 也可以使用 NavigateUri 附加属性，但只能从以下属性使用： FixedPage、 Path、 Canvas和 Glyphs。

依赖项属性信息

标识符字段	NavigateUriProperty
元数据属性设置为 true	无