HyperlinkButton.NavigateUri 속성

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

HyperlinkButton을 클릭할 때 탐색할 URI(Uniform Resource Identifier)를 가져오거나 설정합니다.

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

Uri NavigateUri();

void NavigateUri(Uri value);

public System.Uri NavigateUri { get; set; }

var uri = hyperlinkButton.navigateUri;
hyperlinkButton.navigateUri = uri;

Public Property NavigateUri As Uri

<HyperlinkButton NavigateUri="uriString"/>

속성 값

Uri Uri

HyperlinkButton을 클릭할 때 탐색할 URI(Uniform Resource Identifier)입니다.

예제

다음은 XAML에 선언된 HyperlinkButton 입니다. Content에 대한 문자열 값과 NavigateUri 값을 선언합니다.

<HyperlinkButton Content="www.microsoft.com" NavigateUri="https://www.microsoft.com"/>

설명

사용자가 HyperlinkButton을 클릭하거나 호출하면 기본 브라우저에서 NavigateUri 속성에 대해 지정한 URI가 열립니다.

URI에 대해 http: 또는 https: 체계를 사용할 필요가 없습니다. 브라우저에서 로드하기 적합한 위치에 리소스 콘텐츠가 있으면 ms-appx:, ms-appdata: 또는 ms-resources:와 같은 체계를 사용할 수 있습니다. 그러나 file: 체계는 특별히 차단됩니다. 자세한 내용은 URI 체계를 참조하세요.

HyperlinkButton 은 컨트롤이므로 Tapped와 같은 입력 이벤트가 있고 ButtonBase 하위 클래스이므로 Click 이벤트도 있습니다. 일반적으로 NavigateUri에 대한 값을 지정하지 않으며 HyperlinkButton을 클릭하는 것으로 해석되는 입력 이벤트도 처리합니다. 기본 브라우저에서 NavigateUri를 여는 작업은 이벤트 처리 없이 발생하는 시스템 작업입니다. HyperlinkButton이 앱의 일부이기도 한 WebView2 컨트롤 내에서 지정된 URI를 로드하려는 경우 NavigateUri에 대한 값을 지정하지 마세요. 대신 Click 이벤트를 처리하고 WebView2.Source 속성을 로드할 URI로 설정합니다.

추가 정보

• 하이퍼링크