Hyperlink.NavigateUri Propriedade

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Obtém ou define um URI para o qual navegar quando o Hyperlink estiver ativado.

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

Uri

O URI para o qual navegar quando o Hyperlink é ativado. O padrão é null.

Atributos

BindableAttribute LocalizabilityAttribute

Exemplos

O exemplo a seguir 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 NavigateUri propriedade 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 a seguir mostra como usar um mailto: URI (uniform resource identifier) para abrir uma nova janela de email que contém um endereço de email, um endereço de email e um assunto e 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>

Comentários

Para vincular a um elemento embutido específico, especifique o nome do elemento precedido por um símbolo de libra (#).

Hyperlink poderá navegar até o valor da NavigateUri propriedade somente se o pai direto ou indireto de um Hyperlink for um host de navegação, incluindo NavigationWindow, Frameou qualquer navegador que possa hospedar XBAPs. Para obter mais informações, consulte a seção Hosts de navegação em Visão geral da navegação.

Quando um usuário passa o mouse sobre um em um Hyperlink XBAP, o URI armazenado na NavigateUri propriedade é exibido na barra de status. Hyperlink navega até esse URI quando o usuário clica no Hyperlink. Se o valor da NavigateUri propriedade for alterado depois que o usuário clicar no Hyperlink e antes da solicitação de navegação subsequente, Hyperlink ignorará o novo valor da NavigateUri propriedade e navegará até o URI que era o valor da NavigateUri propriedade quando o usuário clicou no Hyperlink.

Observação

Você não está restrito a usar apenas um Hyperlink para fazer navegação. Você também pode usar a NavigateUri propriedade anexada, mas somente do seguinte: FixedPage, Path, Canvase Glyphs.

Informações da propriedade de dependência

Campo Identificador	NavigateUriProperty
Propriedades de metadados definidas como true	Nenhum