Hyperlink.NavigateUri Eigenschap

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

Waarde van eigenschap

De URI om naar te navigeren wanneer de Hyperlink is geactiveerd. De standaardwaarde is null.

Kenmerken

BindableAttribute LocalizabilityAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u het NavigateUri kenmerk van een Hyperlink element gebruikt.

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

In het volgende voorbeeld ziet u hoe u de eigenschap NavigateUri programmatisch instelt.

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)

In het volgende voorbeeld ziet u hoe u een mailto gebruikt: uniform resource identifier (URI) om een nieuw e-mailvenster te openen dat een e-mailadres, een e-mailadres en een onderwerp en een e-mailadres, onderwerp en hoofdtekst bevat.

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

Opmerkingen

Als u een koppeling wilt maken naar een bepaald inline-element, geeft u de elementnaam op die wordt voorafgegaan door een hekje (#).

Hyperlink kan alleen naar de waarde van de NavigateUri eigenschap navigeren als het directe of indirecte bovenliggende element van een Hyperlink is een navigatiehost, inclusief NavigationWindow, Frameof een browser die XBAPs kan hosten. Zie de sectie Navigatiehosts in Navigatieoverzicht voor meer informatie.

Wanneer een gebruiker de muisaanwijzer boven een Hyperlink in een XBAP houdt, wordt de URI die in de NavigateUri eigenschap is opgeslagen, weergegeven op de statusbalk. Hyperlink navigeert naar deze URI wanneer de gebruiker op de HyperlinkURI klikt. Als de waarde van de NavigateUri eigenschap verandert nadat de gebruiker op de Hyperlink en voor de volgende navigatieaanvraag klikt, negeert u Hyperlink de nieuwe waarde van de NavigateUri eigenschap en navigeert u naar de URI die de waarde van de NavigateUri eigenschap was toen de gebruiker op de Hyperlink.

Informatie over afhankelijkheidseigenschappen