Hyperlink.NavigateUri Propriété

Définition

Espace de noms:

System.Windows.Documents

Assembly:

PresentationFramework.dll

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 vers lequel accéder lorsque est Hyperlink activé. La valeur par défaut est null.

Attributs

BindableAttribute LocalizabilityAttribute

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 URI (Uniform Resource Identifier) pour ouvrir une nouvelle fenêtre de courrier 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 est un hôte de navigation, y compris NavigationWindow, Frameou tout navigateur pouvant héberger des XBAPs. 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 dans un XBAP, l’URI stocké dans la NavigateUri propriété s’affiche dans la barre de status. Hyperlinkaccède à cet URI lorsque l’utilisateur clique sur .Hyperlink Si la valeur de la NavigateUri propriété change après que l’utilisateur clique sur et Hyperlink 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é à l’utilisation d’une Hyperlink navigation à faire. Vous pouvez également utiliser la NavigateUri propriété jointe, mais uniquement à partir des éléments suivants : FixedPage, Path, Canvaset Glyphs.

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

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