Hyperlink.NavigateUri Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Documents

Ottiene o imposta l'URI (Uniform Resource Identifier) a cui passare quando viene attivato il collegamento ipertestuale .

public:
 property Uri ^ NavigateUri { Uri ^ get(); void set(Uri ^ value); };

Uri NavigateUri();

void NavigateUri(Uri value);

public System.Uri NavigateUri { get; set; }

var uri = hyperlink.navigateUri;
hyperlink.navigateUri = uri;

Public Property NavigateUri As Uri

<Hyperlink NavigateUri="uriString"/>

Valore della proprietà

Uri Uri

URI (Uniform Resource Identifier) a cui passare quando viene attivato il collegamento ipertestuale . Il valore predefinito è Null.

Commenti

Per impostazione predefinita, un collegamento ipertestuale viene visualizzato come collegamento ipertestuale di testo. Quando un utente lo fa clic, apre l'URI specificato nella proprietà NavigateUri nel browser predefinito. In particolare, viene avviato nell'app registrata per lo schema/protocollo specifico specificato nel valore NavigateUri. Il browser predefinito è un processo separato dall'app. L'esperienza utente tipica è che una nuova app del browser viene visualizzata come riquadro di divisione insieme all'app e il browser ottiene lo stato attivo.

Non è necessario gestire l'evento Click per causare la navigazione quando si specifica un valore per NavigateUri. L'evento Click è destinato alla navigazione all'interno dell'app, ad esempio se si vuole caricare una nuova pagina dell'app e per tale scenario non è necessario un valore NavigateUri. Non è inoltre possibile eseguire alcuna operazione all'interno del gestore eventi Click per impedire al browser predefinito di caricare qualsiasi destinazione valida specificata per NavigateUri; tale azione viene eseguita automaticamente (in modo asincrono) quando il collegamento ipertestuale viene attivato e non può essere annullato dall'interno del gestore eventi Click .

Se la finalità è che il collegamento ipertestuale deve caricare un URI specificato all'interno di un controllo WebView2 che fa anche parte dell'app, non specificare un valore per NavigateUri. Gestire invece l'evento Click e chiamare WebView2.Source, specificando l'URI da caricare.

Non devi necessariamente usare gli schemi http: o https:. Puoi usare schemi come ms-appx:, ms-appdata: o ms-resources: se in queste posizioni è presente contenuto di risorse appropriato per il caricamento in un browser. Lo schema file: è tuttavia specificatamente bloccato. Per altre info, vedi schemi URI.

Vedi anche

• Click