Hyperlink.NavigateUri 속성

정의

네임스페이스:

Microsoft.UI.Xaml.Documents

하이퍼링크가 활성화될 때 탐색할 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 = hyperlink.navigateUri;
hyperlink.navigateUri = uri;

Public Property NavigateUri As Uri

<Hyperlink NavigateUri="uriString"/>

속성 값

Uri Uri

하이퍼링크가 활성화될 때 탐색할 URI(Uniform Resource Identifier)입니다. 기본값은 null입니다.

설명

기본적으로 하이퍼링크 는 텍스트 하이퍼링크로 표시됩니다. 사용자가 클릭하면 기본 브라우저의 NavigateUri 속성에 지정한 URI가 열립니다. (구체적으로는 NavigateUri 값에 지정된 대로 특정 체계/프로토콜에 등록된 앱에서 시작됩니다.) 기본 브라우저는 앱과 별도의 프로세스입니다. 일반적인 사용자 환경은 새 브라우저 앱이 앱과 함께 분할 창으로 표시되고 브라우저에 포커스가 있다는 것입니다.

NavigateUri에 대한 값을 지정할 때 탐색을 발생시키는 Click 이벤트를 처리할 필요가 없습니다. Click 이벤트는 앱 내에서 탐색을 위한 것입니다. 예를 들어 새 앱 페이지를 로드하려는 경우와 해당 시나리오의 경우 NavigateUri 값이 필요하지 않습니다. Click 이벤트 처리기 내에서 기본 브라우저가 NavigateUri에 지정된 유효한 대상을 로드하지 못하도록 할 수 있는 작업도 없습니다. 이 작업은 하이퍼링크가 활성화되고 Click 이벤트 처리기 내에서 취소할 수 없는 경우 자동으로(비동기적으로) 수행됩니다.

하이퍼링크가 앱의 일부이기도 한 WebView2 컨트롤 내에서 지정된 URI를 로드하려는 경우 NavigateUri에 대한 값을 지정하지 마세요. 대신 Click 이벤트를 처리하고 WebView2.Source를 호출하여 로드할 URI를 지정합니다.

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

추가 정보

• Click