Hyperlink.NavigateUri Propriedade

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

Valor de Propriedade

O URI para navegar quando é Hyperlink ativado. A predefinição é null.

Atributos

BindableAttribute LocalizabilityAttribute

Exemplos

O exemplo seguinte mostra como usar o NavigateUri atributo de um Hyperlink elemento.

<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>

O exemplo a seguir mostra como definir a propriedade NavigateUri programaticamente.

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)

O exemplo seguinte mostra como usar um mailto: identificador uniforme de recurso (URI) para abrir uma nova janela de email que contém um endereço de email, um endereço de email e um assunto, bem como um endereço de email, assunto e corpo.

<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>

Observações

Para ligar a um elemento inline em particular, especifique o nome do elemento precedido por um símbolo de libra (#).

Hyperlink só pode navegar para o valor da NavigateUri propriedade se o pai direto ou indireto de a Hyperlink for um host de navegação, incluindo NavigationWindow, Frame, ou qualquer navegador que possa hospedar XBAPs. Para mais informações, consulte a secção Anfitriões de Navegação na Visão Geral da Navegação.

Quando um utilizador passa o rato sobre a Hyperlink num XBAP, o URI armazenado na NavigateUri propriedade é exibido na barra de estado. Hyperlink navega até este URI quando o utilizador clica no Hyperlinkarquivo . Se o valor da NavigateUri propriedade mudar após o utilizador clicar no Hyperlink e antes do pedido de navegação subsequente, Hyperlink ignorar o novo valor da NavigateUri propriedade e navegar até ao URI que era o valor da NavigateUri propriedade quando o utilizador clicou no Hyperlink.

Informação de Propriedade de Dependência