Hyperlink.NavigateUri Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Documents

Obtient ou définit l’URI (Uniform Resource Identifier) auquel accéder lorsque le lien hypertexte est activé.

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

Valeur de propriété

Uri Uri

URI (Uniform Resource Identifier) auquel accéder lorsque le lien hypertexte est activé. La valeur par défaut est Null.

Remarques

Par défaut, un lien hypertexte apparaît sous la forme d’un lien hypertexte de texte. Lorsqu’un utilisateur clique dessus, il ouvre l’URI que vous spécifiez dans la propriété NavigateUri dans le navigateur par défaut. (Plus précisément, il est lancé dans l’application inscrite pour le schéma/protocole particulier, comme vous l’avez spécifié dans la valeur NavigateUri.) Le navigateur par défaut est un processus distinct de votre application. L’expérience utilisateur classique est qu’une nouvelle application de navigateur apparaît sous la forme d’un volet fractionné à côté de votre application, et que le navigateur obtient le focus.

Vous n’avez pas besoin de gérer l’événement Click pour provoquer la navigation lorsque vous spécifiez une valeur pour NavigateUri. L’événement Click est destiné à la navigation au sein de l’application, par exemple si vous souhaitez charger une nouvelle page d’application et que, pour ce scénario, vous n’avez pas besoin d’une valeur NavigateUri. Vous ne pouvez pas non plus faire dans le gestionnaire d’événements Click pour empêcher le navigateur par défaut de charger une cible valide spécifiée pour NavigateUri ; cette action se produit automatiquement (de façon asynchrone) lorsque le lien hypertexte est activé et ne peut pas être annulé à partir du gestionnaire d’événements Click .

Si vous souhaitez que le lien hypertexte charge un URI spécifié dans un contrôle WebView2 qui fait également partie de votre application, ne spécifiez pas de valeur pour NavigateUri. Gérez plutôt l’événement Click et appelez WebView2.Source, en spécifiant l’URI à charger.

Vous n’êtes pas tenu d’utiliser les schémas http: ou https:. Vous pouvez utiliser des schémas tels que ms-appx:, ms-appdata: ou ms-ressources: si le contenu des ressources à ces emplacements peut être chargé dans un navigateur. Toutefois, le schéma file: est bloqué. Pour plus d’informations, voir Schémas d’URI.

Voir aussi

• Click