정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

Launcher.LaunchUriAsync(Uri) | launchUriAsync(Uri) Method

지정된 URI의 URI 체계 이름과 연결된 기본 앱을 시작합니다.

구문


Windows.System.Launcher.launchUriAsync(uri).done( /* 성공 및 오류 처리기 */ );

매개 변수

uri

형식: Windows.Foundation.Uri [JavaScript] | System.Uri [.NET] | Windows::Foundation::Uri [C++]

URI입니다.

반환 값

형식: IAsyncOperation<Boolean>

시작 작업입니다.

설명

호출 앱은 API가 호출될 때 사용자에게 표시되어야 합니다.

네트워크 위치를 가리키는 file:/// URI와 같은 인트라넷 URI를 시작하려면 매니페스트에 privateNetworkClientServer 기능을 지정해야 합니다.

이 메서드를 사용하여 현재 시간대에 URI를 시작할 수 없습니다. 예를 들어 앱은 file:/// 프로토콜을 사용하여 로컬 컴퓨터에 있는 파일에 액세스할 수 없습니다. 대신 Storage APIs를 사용하여 파일에 액세스해야 합니다.

위와 같은 이유로 시작하지 못하면 API가 성공하고 비동기 작업에서 FALSE를 반환합니다.

사용자가 기본 앱을 시작하는 대신 앱을 선택할 수 있도록 하려면 LauncherOptions.DisplayApplicationPicker | displayApplicationPicker 속성을 설정합니다.

URI가 잠재적으로 안전하지 않다는 경고를 표시하려면 LauncherOptions.TreatAsUntrusted | treatAsUntrusted 속성을 설정합니다.

URI는 연결된 앱으로 전달됩니다. 연결된 앱이 데스크톱 앱일 경우 URI는 셸 실행 메커니즘을 사용하여 전달됩니다.

예제

이 예제에서는 LaunchUriAsync(Uri) | launchUriAsync(Uri)를 사용하여 URI를 시작합니다.



// The URI to launch
var uriToLaunch = "http://www.bing.com";

// Create a Uri object from a URI string 
var uri = new Windows.Foundation.Uri(uriToLaunch);

// Launch the URI
Windows.System.Launcher.launchUriAsync(uri).then(   
   function (success) {
      if (success) {
        // URI launched
      } else {
        // URI launch failed
      }
   });

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8

Namespace

Windows.System
Windows::System [C++]

Metadata

Windows.winmd

참고 항목

샘플
연결 시작 샘플
지침
파일 형식 및 URI를 위한 지침 및 검사 목록
작업
URI의 기본 앱을 시작하는 방법(JavaScript)
URI의 기본 앱을 시작하는 방법(C#/VB/C++)
참조
Launcher
LauncherOptions

 

 

표시: