Hyperlink.NavigateUri Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Documents

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen URI ab, zu dem navigiert werden soll, wenn der Hyperlink aktiviert wird, oder legt diesen fest.

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

Uri

Der URI, zu dem navigiert werden soll, zu dem die Hyperlink Aktivierung erfolgt. Der Standardwert ist 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 Sie die NavigateUri-Eigenschaft programmatisch einstellen können.

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 verwenden: uniform resource identifier (URI), um ein neues E-Mail-Fenster zu öffnen, das eine E-Mail-Adresse, eine E-Mail-Adresse und einen Betreff enthält, und eine E-Mail-Adresse, einen Betreff und einen Textkörper.

<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 Vornamen eines Pfundsymbols (#) an.

Hyperlink kann nur dann zum Wert der NavigateUri Eigenschaft navigieren, wenn es sich entweder um den direkten oder indirekten übergeordneten Element eines Hyperlink Navigationshosts handelt, einschließlich NavigationWindow, Frameoder einen beliebigen Browser, der XBAPs hosten kann (einschließlich Internet Explorer 6 und höherer Versionen und Firefox 2.0+). Weitere Informationen finden Sie im Abschnitt "Navigationshosts" in der Navigationsübersicht.

Wenn ein Benutzer die Maus über einen Hyperlink XBAP bewegt, wird der in der NavigateUri Eigenschaft gespeicherte URI in der Statusleiste angezeigt. Hyperlink Navigiert zu diesem URI, wenn der Benutzer auf die Hyperlink. 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, wenn der Benutzer auf die HyperlinkEigenschaft geklickt hat.

Hinweis

Sie sind nicht nur auf die Verwendung einer Hyperlink Navigation beschränkt. Sie können auch die NavigateUri angefügte Eigenschaft verwenden, aber nur aus den folgenden: FixedPage, Path, Canvas, und Glyphs.

Informationen zur Abhängigkeitseigenschaft


Bezeichnerfeld	NavigateUriProperty
Metadateneigenschaften auf `true` festgelegt	Keine

Gilt für: