Hyperlink.NavigateUri Propiedad

Definición

Espacio de nombres:

System.Windows.Documents

Ensamblado:

PresentationFramework.dll

Obtiene o establece un URI al que navegar cuando Hyperlink se activa .

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 propiedad

Uri

Identificador URI al que se va a navegar cuando Hyperlink se activa . El valor predeterminado es null.

Atributos

BindableAttribute LocalizabilityAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo usar el NavigateUri atributo de un 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>

En el ejemplo siguiente se muestra cómo establecer la NavigateUri propiedad mediante programación.

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)

En el ejemplo siguiente se muestra cómo usar un mailto: identificador uniforme de recursos (URI) para abrir una nueva ventana de correo que contiene una dirección de correo electrónico, una dirección de correo electrónico y un asunto, y una dirección de correo electrónico, asunto y cuerpo.

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

Comentarios

Para vincular a un elemento insertado determinado, especifique el nombre del elemento precedido por un símbolo de libra (#).

Hyperlink puede navegar hasta el valor de la NavigateUri propiedad solo si el elemento primario directo o indirecto de un Hyperlink es un host de navegación, incluidos NavigationWindow, Frameo cualquier explorador que pueda hospedar XBAP. Para obtener más información, consulte la sección Hosts de navegación en Información general de navegación.

Cuando un usuario mantiene el mouse sobre en un Hyperlink XBAP, el URI almacenado en la NavigateUri propiedad se muestra en la barra de estado. Hyperlinknavega a este URI cuando el usuario hace clic en .Hyperlink Si el valor de la NavigateUri propiedad cambia después de que el usuario haga clic en Hyperlink y antes de la solicitud de navegación posterior, Hyperlink omite el nuevo valor de la NavigateUri propiedad y navega hasta el URI que era el valor de la NavigateUri propiedad cuando el usuario hizo Hyperlinkclic en .

Nota:

No está restringido a usar solo para Hyperlink realizar la navegación. También puede usar la NavigateUri propiedad adjunta, pero solo desde lo siguiente: FixedPage, Path, Canvasy Glyphs.

Información de la propiedad dependency

Elemento	Importancia
Campo identificador	NavigateUriProperty
Propiedades de metadatos establecidas en true	Ninguno