Hyperlink.NavigateUri Propriété

Définition

Obtient ou définit un URI vers lequel naviguer quand Hyperlink est activé.

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

Valeur de propriété

Uri

URI à accéder au moment de l’activation Hyperlink . La valeur par défaut est null.

Attributs

Exemples

L’exemple suivant montre comment utiliser l’attribut NavigateUri d’un Hyperlink élément.

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

L’exemple suivant montre comment définir la NavigateUri propriété par programmation.

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)

L’exemple suivant montre comment utiliser un mailto : URI (Uniform Resource Identifier) pour ouvrir une nouvelle fenêtre de messagerie contenant une adresse e-mail, une adresse e-mail et un objet, ainsi qu’une adresse e-mail, un objet et un corps.

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

Remarques

Pour établir un lien vers un élément inline particulier, spécifiez le nom de l’élément précédé d’un symbole dièse (#).

Hyperlink peut accéder à la valeur de la NavigateUri propriété uniquement si le parent direct ou indirect d’un Hyperlink hôte de navigation est un hôte de navigation, y compris NavigationWindow, Frameou n’importe quel navigateur qui peut héberger des adresses XBAPs (qui inclut Internet Explorer 6 et versions ultérieures, et Firefox 2.0+). Pour plus d’informations, consultez la section Hôtes de navigation dans Vue d’ensemble de la navigation.

Lorsqu’un utilisateur pointe la souris sur un Hyperlink XBAP, l’URI stocké dans la NavigateUri propriété s’affiche dans la barre d’état. Hyperlink accède à cet URI lorsque l’utilisateur clique sur le Hyperlink. Si la valeur de la NavigateUri propriété change après que l’utilisateur clique sur la Hyperlink requête de navigation suivante et avant la demande de navigation suivante, Hyperlink ignore la nouvelle valeur de la NavigateUri propriété et accède à l’URI qui était la valeur de la NavigateUri propriété lorsque l’utilisateur a cliqué sur le Hyperlink.

Notes

Vous n’êtes pas limité uniquement à l’utilisation d’une Hyperlink navigation. Vous pouvez également utiliser la NavigateUri propriété jointe, mais uniquement à partir des éléments suivants : FixedPage, , CanvasPath, et Glyphs.

Informations sur les propriétés de dépendance

Champ d’identificateur NavigateUriProperty
Propriétés de métadonnées définies sur true Aucun

S’applique à