Hyperlink.NavigateUri Eigenschaft

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

Eigenschaftswert

Der URI, zu dem navigiert werden soll, wann die Hyperlink Aktivierung erfolgt. Der Standardwert lautet null.

Attribute

BindableAttribute LocalizabilityAttribute

Beispiele

Das folgende Beispiel zeigt, wie das NavigateUri Attribut eines Hyperlink Elements verwendet wird.

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

Das folgende Beispiel zeigt, wie die NavigateUri-Eigenschaft programmgesteuert festgelegt wird.

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)

Das folgende Beispiel zeigt, wie Sie einen mailto: Uniform Resource Identifier (URI) verwenden, um ein neues E-Mail-Fenster zu öffnen, das eine E-Mail-Adresse, eine E-Mail-Adresse und einen Betreff sowie eine E-Mail-Adresse, einen Betreff und einen Text enthält.

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

Hinweise

Wenn Sie eine Verknüpfung mit einem bestimmten Inlineelement herstellen möchten, geben Sie den Elementnamen an, dem ein Nummernsymbol (#) vorangestellt ist.

Hyperlink kann nur dann zum Wert der NavigateUri Eigenschaft navigieren, wenn entweder das direkte oder indirekte übergeordnete Element eines Hyperlink Elements ein Navigationshost ist, einschließlich NavigationWindow, Frameoder ein beliebiger Browser, der XBAPs hosten kann. Weitere Informationen finden Sie im Abschnitt "Navigationshosts" in der Navigationsübersicht.

Wenn ein Benutzer mit der Maus auf eine Hyperlink XBAP zeigt, wird der in der Eigenschaft gespeicherte URI in der NavigateUri Statusleiste angezeigt. Hyperlink navigiert zu diesem URI, wenn der Benutzer auf die HyperlinkURI klickt. Wenn sich der Wert der NavigateUri Eigenschaft ändert, nachdem der Benutzer auf die Hyperlink und vor der nachfolgenden Navigationsanforderung geklickt hat, Hyperlink ignoriert den neuen Wert der NavigateUri Eigenschaft und navigiert zum URI, der der Wert der NavigateUri Eigenschaft war, als der Benutzer auf die HyperlinkEigenschaft geklickt hat.

Informationen zur Abhängigkeitseigenschaft