Hyperlink.NavigateUri Egenskap

Definition

Hämtar eller anger en URI att navigera till när aktiveras Hyperlink .

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

Egenskapsvärde

Uri

Den URI som ska navigeras till när Hyperlink aktiveras. Standardvärdet är null.

Attribut

Exempel

I följande exempel visas hur du använder NavigateUri attributet för ett Hyperlink element.

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

I följande exempel visas hur du ställer in NavigateUri-egenskapen programmatiskt.

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)

I följande exempel visas hur du använder en e-postadress: URI (uniform resource identifier) för att öppna ett nytt e-postfönster som innehåller en e-postadress, en e-postadress och ett ämne samt en e-postadress, ämne och brödtext.

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

Kommentarer

Om du vill länka till ett visst infogat element anger du det elementnamn som föregås av en pundsymbol (#).

Hyperlink kan endast navigera till värdet för NavigateUri egenskapen om antingen den direkta eller indirekta överordnade egenskapen för en Hyperlink är en navigeringsvärd, inklusive NavigationWindow, Frameeller en webbläsare som kan vara värd för XBAP:er. Mer information finns i avsnittet Navigeringsvärdar i Navigeringsöversikt.

När en användare hovrar musen över en Hyperlink i en XBAP visas den URI som lagras i NavigateUri egenskapen i statusfältet. Hyperlink navigerar till den här URI:n när användaren klickar på Hyperlink. Om värdet för NavigateUri egenskapen ändras när användaren klickar på Hyperlink och före den efterföljande navigeringsbegäran Hyperlink ignorerar du det nya värdet NavigateUri för egenskapen och navigerar till den URI som var värdet NavigateUri för egenskapen när användaren klickade Hyperlinkpå .

Note

Du är inte begränsad till att bara använda en Hyperlink för att göra-navigering. Du kan också använda den NavigateUri bifogade egenskapen, men bara från följande: FixedPage, Path, Canvasoch Glyphs.

Information om beroendeegenskap

Item Value
Identifierarfält NavigateUriProperty
Metadataegenskaper inställda på true None

Gäller för