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 элемент является узлом навигации, включая NavigationWindow, Frameили любой браузер, в котором могут размещаться XBAP-приложения (включая Internet Explorer 6 и более поздние версии, а также Firefox 2.0 и более поздних версий). Дополнительные сведения см. в разделе Узлы навигации статьи Обзор навигации.

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

Примечание

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

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

Поле идентификатора	NavigateUriProperty
Для свойств метаданных задано значение true	Нет