Hyperlink.NavigateUri Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia identyfikator URI, aby przejść do momentu Hyperlink aktywowania.

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

Wartość właściwości

Uri

Identyfikator URI, do który ma przejść po Hyperlink aktywowaniu. Wartość domyślna to null.

Atrybuty

BindableAttribute LocalizabilityAttribute

Przykłady

W poniższym przykładzie pokazano, jak używać NavigateUri atrybutu Hyperlink elementu.

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

W poniższym przykładzie pokazano, jak programowo ustawić NavigateUri właściwość.

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)

W poniższym przykładzie pokazano, jak używać adresu mailto: jednolity identyfikator zasobu (URI), aby otworzyć nowe okno poczty zawierające adres e-mail, adres e-mail i temat oraz adres e-mail, temat i treść.

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

Uwagi

Aby połączyć się z określonym elementem wbudowanym, określ nazwę elementu poprzedzoną symbolem funta (#).

Hyperlink Może przejść do wartości NavigateUri właściwości tylko wtedy, gdy bezpośredni lub pośredni element nadrzędny elementu jest Hyperlink hostem nawigacji, w tym NavigationWindow, Framelub dowolną przeglądarką, która może hostować XBAPs. Aby uzyskać więcej informacji, zobacz sekcję Hosty nawigacji w sekcji Przegląd nawigacji.

Gdy użytkownik najecha kursor myszy na Hyperlink element w XBAP, identyfikator URI przechowywany we NavigateUri właściwości jest wyświetlany na pasku stanu. Hyperlink przechodzi do tego identyfikatora URI, gdy użytkownik kliknie element Hyperlink. Jeśli wartość NavigateUri właściwości zmieni się po kliknięciu Hyperlink elementu i przed kolejnym żądaniem nawigacji, Hyperlink ignoruje nową wartość NavigateUri właściwości i przechodzi do identyfikatora URI, który był wartością NavigateUri właściwości, gdy użytkownik kliknął Hyperlinkelement .

Uwaga

Nie masz ograniczeń tylko do nawigacji za pomocą elementu do Hyperlink nawigacji. Można również użyć dołączonej NavigateUri właściwości, ale tylko z następujących: FixedPage, , PathCanvasi Glyphs.

Informacje dotyczące właściwości zależności

Pole identyfikatora	NavigateUriProperty
Właściwości metadanych ustawione na true	Brak