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

Im folgenden Beispiel wird gezeigt, 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

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. Weitere Informationen finden Sie im Abschnitt Navigationshosts in der Navigationsübersicht.

Wenn ein Benutzer mit dem Mauszeiger auf eine Hyperlink in einer XBAP-Datei zeigt, wird der in der NavigateUri -Eigenschaft gespeicherte URI in der status leiste 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

Gilt für:

Freigeben über