Hyperlink.NavigateUri Proprietà

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Ottiene o imposta un URI a cui passare quando l'oggetto Hyperlink viene attivato.

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

Valore della proprietà

Uri

URI da passare a quando Hyperlink viene attivato . Il valore predefinito è null.

Attributi

BindableAttribute LocalizabilityAttribute

Esempio

Nell'esempio seguente viene illustrato come usare l'attributo NavigateUri di un Hyperlink elemento .

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

Nell'esempio seguente viene illustrato come impostare la proprietà NavigateUri a livello di codice.

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)

Nell'esempio seguente viene illustrato come usare un mailto: URI (Uniform Resource Identifier) per aprire una nuova finestra di posta contenente un indirizzo di posta elettronica, un indirizzo di posta elettronica e un oggetto e un indirizzo di posta elettronica, un oggetto e un corpo.

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

Commenti

Per collegarsi a un particolare elemento inline, specificare il nome dell'elemento preceduto da un simbolo di cancelletto (#).

Hyperlink può passare al valore della NavigateUri proprietà solo se l'elemento padre diretto o indiretto di un Hyperlink è un host di navigazione, incluso NavigationWindow, Frameo qualsiasi browser in grado di ospitare XBAP. Per altre informazioni, vedere la sezione Host di spostamento in Cenni preliminari sulla navigazione.

Quando un utente passa il puntatore del mouse su un Hyperlink oggetto in un XBAP, l'URI archiviato nella NavigateUri proprietà viene visualizzato nella barra di stato. Hyperlink passa a questo URI quando l'utente fa clic su Hyperlink. Se il valore della NavigateUri proprietà viene modificato dopo che l'utente fa clic Hyperlink su e prima della richiesta di navigazione successiva, Hyperlink ignora il nuovo valore della NavigateUri proprietà e passa all'URI che corrisponde al valore della NavigateUri proprietà quando l'utente ha fatto clic su Hyperlink.

Annotazioni

Non è possibile limitarsi solo all'uso di un Hyperlink oggetto per eseguire la navigazione. È anche possibile usare la NavigateUri proprietà associata, ma solo dagli elementi seguenti: FixedPage, Path, Canvase Glyphs.

Informazioni sulle proprietà di dipendenza

Elemento	Valore
Campo Identificatore	NavigateUriProperty
Proprietà dei metadati impostate su true	Nessuno