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

Универсальный код ресурса (URI), к которому необходимо перейти при Hyperlink активации. Значение по умолчанию — 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может переходить к значению NavigateUri свойства только в том случае, если прямой или косвенный родительский элемент Hyperlink является узлом навигации, включая NavigationWindowFrameили любой браузер, который может размещать XBAPs. Дополнительные сведения см. в разделе "Узлы навигации" в обзоре навигации.

Когда пользователь наведите указатель мыши на Hyperlink XBAP, URI, хранящийся в свойстве, отображается в NavigateUri строке состояния. Hyperlink переходит к этому универсальному коду ресурса (URI), когда пользователь щелкает его Hyperlink. Если значение NavigateUri свойства изменяется после того, как пользователь щелкает Hyperlink последующий запрос навигации, Hyperlink игнорирует новое значение свойства и переходит к URI, который был значением NavigateUriNavigateUri свойства при щелчке Hyperlinkпользователя.

Замечание

Вы не ограничены только использованием навигации Hyperlink . Также можно использовать присоединенное NavigateUri свойство, но только из следующих элементов: FixedPage, , PathCanvasи Glyphs.

Сведения о свойстве зависимостей

Элемент	Ценность
Поле идентификатора	NavigateUriProperty
Свойства метаданных, равные свойству true	Нет