Hyperlink.NavigateUri Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Documents

Obtém ou define o URI (Uniform Resource Identifier) para o qual navegar quando o Hiperlink é ativado.

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

Valor da propriedade

Uri Uri

O URI (Uniform Resource Identifier) para o qual navegar quando o hiperlink é ativado. O padrão é nulo.

Comentários

Por padrão, um Hiperlink aparece como um hiperlink de texto. Quando um usuário clica nele, ele abre o URI especificado na propriedade NavigateUri no navegador padrão. (Mais especificamente, ele é iniciado no aplicativo registrado para o esquema/protocolo específico conforme especificado no valor NavigateUri.) O navegador padrão é um processo separado do seu aplicativo. A experiência típica do usuário é que um novo aplicativo de navegador aparece como um painel dividido ao lado do seu aplicativo e o navegador fica em foco.

Você não precisa manipular o evento Click para causar a navegação ao especificar um valor para NavigateUri. O evento Click destina-se à navegação dentro do aplicativo, por exemplo, se você quiser que uma nova página de aplicativo seja carregada e, para esse cenário, você não precisa de um valor NavigateUri. Também não há nada que você possa fazer no manipulador de eventos Click para impedir que o navegador padrão carregue qualquer destino válido especificado para NavigateUri; essa ação ocorre automaticamente (de forma assíncrona) quando o hiperlink é ativado e não pode ser cancelado de dentro do manipulador de eventos Click .

Se sua intenção é que o Hiperlink carregue um URI especificado dentro de um controle WebView2 que também faz parte do seu aplicativo, não especifique um valor para NavigateUri. Manipule o evento Click e chame WebView2.Source, especificando o URI a ser carregado.

Você não precisa usar esquemas http: nem https:. Poderá usar esquemas como ms-appx:, ms-appdata: ou ms-resources: se houver conteúdo de recurso nesses locais que seja apropriado carregar em um navegador. No entanto, o esquema file: é especificamente bloqueado. Para obter mais informações, consulte Esquemas de URI.

Confira também

• Click