Hyperlink.NavigateUri Propiedad

Definición

Espacio de nombres:

System.Windows.Documents

Ensamblado:

PresentationFramework.dll

Obtiene o establece un URI al que ir cuando se activa 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

Valor de propiedad

Uri

Identificador URI al que se va a navegar cuando Hyperlink se activa . De manera predeterminada, 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 propiedad NavigateUri 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, incluido NavigationWindow, Frameo cualquier explorador que pueda hospedar XBAPs. Para obtener más información, vea la sección Hosts de navegación en Información general de navegación.

Cuando un usuario mantiene el mouse sobre en Hyperlink un 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 y Hyperlink 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 clic en .Hyperlink

Nota

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

Información sobre propiedades de dependencia

Campo identificador	NavigateUriProperty
Propiedades de metadatos establecidas en true	None