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

LauncherOptions.FallbackUri | fallbackUri Property

파일 형식이나 URI를 처리하기 위한 앱이 없으면 브라우저에서 사용자가 이동해야 할 URI를 나타내는 값을 가져오거나 설정합니다.

구문


var fallbackUri = launcherOptions.fallbackUri;
launcherOptions.fallbackUri = fallbackUri;

속성 값

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

사용자가 브라우저에서 이동해야 하는 URI입니다.

설명

http:// 또는 https:// URI가 포함된 대체(fallback) URI 속성만 설정할 수 있습니다. 이 속성을 설정하고 시작할 파일 또는 URI를 처리하기 위해 설치된 앱이 없을 경우 사용자의 기본 브라우저가 자동으로 시작되고 지정된 URI를 탐색합니다. 이 경우 옵션을 선택할 수 있는 연결 프로그램 대화 상자가 표시되지 않습니다. 파일 또는 URI가 Windows 스토어에 나열되어 있지 않은 데스크톱 앱에서만 지원되는 경우와 같이 사용자를 Windows 스토어에 연결하는 것이 적절하지 않은 경우에만 대체(fallback) URI를 사용해야 합니다. 시작할 파일 또는 URI를 지원하는 Windows 스토어에 앱이 있는 모든 경우에 PreferredApplicationPackageFamilyNamePreferredApplicationDisplayName을 사용하여 해당 앱을 사용자에게 추천해야 합니다.

참고  하나의 대체(fallback)만 사용할 수 있으므로 기본 설정된 응용 프로그램 속성과 대체(fallback) URI를 동시에 설정할 수는 없습니다. 두 대체(fallback)가 모두 설정된 경우 시작 관리자 API가 실패합니다.

Windows 8.1:  Windows 8.1에서 이 속성은 Windows 스토어 URI도 받아들입니다. 이러한 URI를 PreferredApplicationPackageFamilyNamePreferredApplicationDisplayName 속성 대신 사용하여 연결 프로그램 대화 상자를 표시하지 않고 사용자를 스토어의 특정 앱으로 보낼 수 있습니다.

Windows Phone 8

이 API는 구현되어 있지 않으므로 호출할 경우 예외가 throw됩니다. Windows Phone 런타임 API를 참조하십시오.

예제

fallbackUri를 대체(fallback) URI로 설정하여 Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) 메서드를 호출합니다.


// The URI to launch
var uriToLaunch = "contoso:somearguments";

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

// The fallback URI
var uriFallback = "http://www.contoso.com/somearguments";

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

// Set the fallback URI
var options = new Windows.System.LauncherOptions();
options.fallbackUri = fallbackURI;

Windows.System.Launcher.launchUriAsync(uri, options).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

참고 항목

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

 

 

표시: