Hyperlink.NavigateUri Proprietà

Definizione

Ottiene o imposta un URI sul quale spostarsi quando Hyperlink è attivato.

[System.ComponentModel.Bindable(true)]
[System.Windows.Localizability(System.Windows.LocalizationCategory.Hyperlink)]
public Uri NavigateUri { get; set; }

Valore della proprietà

Uri

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

Attributi

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

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

Si applica a

Prodotto Versioni
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9