Hyperlink.NavigateUri Proprietà

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Ottiene o imposta un URI sul quale spostarsi quando Hyperlink è 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 viene attivato .Hyperlink 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 NavigateUri proprietà 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 che contiene 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 eseguire il collegamento 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 oggetto è un host di navigazione, incluso NavigationWindow, Frameo qualsiasi browser in grado di ospitare XBAP. Per altre informazioni, vedere la sezione Host di spostamento in Panoramica della navigazione.

Quando un utente passa il puntatore del mouse su un oggetto in un Hyperlink 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 su Hyperlink e prima della richiesta di navigazione successiva, Hyperlink ignora il nuovo valore della NavigateUri proprietà e passa all'URI che rappresenta il valore della NavigateUri proprietà quando l'utente ha Hyperlinkfatto clic su .

Nota

Non è possibile limitare solo l'uso di un Hyperlink oggetto per eseguire lo spostamento. È anche possibile usare la NavigateUri proprietà associata, ma solo da : FixedPage, Path, Canvase Glyphs.

Informazioni proprietà di dipendenza

Campo Identificatore	NavigateUriProperty
Proprietà dei metadati impostate su true	Nessuno