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 Hyperlink 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 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 collegare un particolare elemento inline, specificare il nome dell'elemento preceduto da un simbolo di sterlina (#).

Hyperlink può passare al valore della NavigateUri proprietà solo se l'elemento padre diretto o indiretto di un è un Hyperlink host di spostamento, incluso NavigationWindow, Frameo qualsiasi browser che può ospitare XBAP (che include Internet Explorer 6 e versioni successive e Firefox 2.0+). Per altre informazioni, vedere la sezione Host di spostamento in Panoramica dello spostamento.

Quando un utente passa il mouse su un oggetto in un Hyperlink XBAP, l'URI archiviato nella proprietà viene visualizzato nella NavigateUri 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 spostamento successiva, Hyperlink ignora il nuovo valore della NavigateUri proprietà e passa all'URI che era il valore della NavigateUri proprietà quando l'utente ha fatto clic su Hyperlink.

Nota

Non è limitato solo all'uso di un Hyperlink oggetto per eseguire lo spostamento. È anche possibile usare la NavigateUri proprietà associata, ma solo dal seguente: FixedPage, PathCanvas, e Glyphs.

Informazioni proprietà di dipendenza

Campo Identificatore	NavigateUriProperty
Proprietà dei metadati impostate su true	Nessuno