Hyperlink.NavigateUri Eigenschaft

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

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, wenn aktiviert Hyperlink wird. Der Standardwert ist null.

Attribute

BindableAttribute LocalizabilityAttribute

Beispiele

Im folgenden Beispiel wird gezeigt, 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 mit einem Mailto: Uniform Resource Identifier (URI) ein neues E-Mail-Fenster ö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

Um eine Verknüpfung mit einem bestimmten Inlineelement zu erstellen, geben Sie den Elementnamen an, dem ein Pfundsymbol (#) vorangestellt ist.

Hyperlink kann nur zum Wert der NavigateUri Eigenschaft navigieren, wenn entweder das direkte oder indirekte übergeordnete Element eines Hyperlink ein Navigationshost ist, einschließlich NavigationWindow, Frameoder eines beliebigen Browsers, der XBAPs hosten kann (einschließlich Internet Explorer 6 und höher und Firefox 2.0 und höher). Weitere Informationen finden Sie im Abschnitt Navigationshosts in der Navigationsübersicht.

Wenn ein Benutzer mit dem Mauszeiger über eine Hyperlink in einer XBAP-Datei bewegt wird, wird der in der NavigateUri -Eigenschaft gespeicherte URI in der Statusleiste angezeigt. Hyperlink navigiert zu diesem URI, wenn der Benutzer auf klickt Hyperlink. Wenn sich der Wert der NavigateUri Eigenschaft ändert, nachdem der Benutzer auf und Hyperlink vor der nachfolgenden Navigationsanforderung geklickt hat, Hyperlink ignoriert den neuen Wert der NavigateUri -Eigenschaft und navigiert zu dem URI, der der Wert der NavigateUri Eigenschaft war, als der Benutzer auf das Hyperlinkgeklickt hat.

Hinweis

Sie sind nicht darauf beschränkt, nur die Navigation zu Hyperlink verwenden. Sie können auch die NavigateUri angefügte Eigenschaft verwenden, aber nur aus den folgenden: FixedPage, Path, Canvasund Glyphs.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	NavigateUriProperty
Metadateneigenschaften auf true festgelegt	Keine