Launcher.LaunchUriAsync 메서드

참조

정의

네임스페이스:: Windows.System

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

LaunchUriAsync(Uri, LauncherOptions, ValueSet)	지정된 옵션 및 입력 데이터를 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 앱을 시작합니다.
LaunchUriAsync(Uri, LauncherOptions)	지정된 옵션을 사용하여 지정된 URI에 대해 URI 구성표 이름 또는 ContentType 지정된 것과 연결된 기본 앱을 시작합니다.
LaunchUriAsync(Uri)	지정된 URI의 URI 체계 이름과 연결된 기본 앱을 시작합니다.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

편집

지정된 옵션 및 입력 데이터를 사용하여 지정된 URI의 URI 체계 이름과 연결된 기본 앱을 시작합니다.

public:
 static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri, LauncherOptions ^ options, ValueSet ^ inputData);

/// [Windows.Foundation.Metadata.Overload("LaunchUriWithDataAsync")]
 static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri, LauncherOptions const& options, ValueSet const& inputData);

[Windows.Foundation.Metadata.Overload("LaunchUriWithDataAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri, LauncherOptions options, ValueSet inputData);

function launchUriAsync(uri, options, inputData)

Public Shared Function LaunchUriAsync (uri As Uri, options As LauncherOptions, inputData As ValueSet) As IAsyncOperation(Of Boolean)

매개 변수

uri: Uri Uri

URI입니다.

options: LauncherOptions

앱의 시작 옵션입니다.

중요하다

옵션 매개 변수의 TargetApplicationPackageFamilyName 속성은 경우에 따라 선택 사항이지만 LaunchUriAsync 메서드의 오버로드에는 필요합니다.

inputData: ValueSet

앱의 입력 데이터입니다.

중요하다

전송할 수 있는 데이터의 양은 100KB를 초과하면 안 됩니다.

반환

IAsyncOperation<Boolean>

IAsyncOperation<bool>

URI 스키마의 기본 앱이 시작된 경우 true 반환합니다. 그렇지 않으면 false .

특성: OverloadAttribute

설명

Windows 데스크톱 애플리케이션에서 이 API를 호출하지 않는 한 이 API는 ASTA 스레드(UI 스레드라고도 함) 내에서 호출되어야 합니다.

이 API는 Windows 데스크톱 애플리케이션에서도 호출할 수 있습니다.

이 API는 UWP(유니버설 Windows 플랫폼) 앱이든 Windows 데스크톱 애플리케이션이든 스키마에 대한 기본 앱을 시작합니다.

추가 정보

적용 대상

LaunchUriAsync(Uri, LauncherOptions)

편집

지정된 옵션을 사용하여 지정된 URI에 대해 URI 구성표 이름 또는 ContentType 지정된 것과 연결된 기본 앱을 시작합니다.

public:
 static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri, LauncherOptions ^ options);

/// [Windows.Foundation.Metadata.Overload("LaunchUriWithOptionsAsync")]
 static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri, LauncherOptions const& options);

[Windows.Foundation.Metadata.Overload("LaunchUriWithOptionsAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri, LauncherOptions options);

function launchUriAsync(uri, options)

Public Shared Function LaunchUriAsync (uri As Uri, options As LauncherOptions) As IAsyncOperation(Of Boolean)

매개 변수

uri: Uri Uri

URI입니다.

options: LauncherOptions

앱의 시작 옵션입니다.

반환

IAsyncOperation<Boolean>

IAsyncOperation<bool>

URI 스키마의 기본 앱이 시작된 경우 true 반환합니다. 그렇지 않으면 false .

특성: OverloadAttribute

예제

이 샘플에서는 [LaunchUriAsync(Uri, LauncherOptions)를 사용하여 경고와 함께 URI를 시작합니다. TreatAsUntrusted 속성은 시스템에 경고가 표시되어야 임을 나타냅니다.

// The URI to launch
string uriToLaunch = @"http://www.bing.com";
var uri = new Uri(uriToLaunch);

async void DefaultLaunch()
{
   // Set the option to show a warning
   var options = new Windows.System.LauncherOptions();
   options.TreatAsUntrusted = true;

   // Launch the URI with a warning prompt
   var success = await Windows.System.Launcher.LaunchUriAsync(uri, options);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

// The URI to launch.
Windows::Foundation::Uri m_uri{ L"http://www.bing.com" };

Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
    // Set the option to show a warning
    Windows::System::LauncherOptions launcherOptions;
    launcherOptions.TreatAsUntrusted(true);

    // Launch the URI.
    if (co_await Windows::System::Launcher::LaunchUriAsync(m_uri, launcherOptions))
    {
        // URI launched.
    }
    else
    {
        // URI launch failed.
    }
}

// The URI to launch
auto uri = ref new Windows::Foundation::Uri("http://www.bing.com");

void MainPage::DefaultLaunch()
{
   // Set the option to show a warning
   auto launchOptions = ref new Windows::System::LauncherOptions();
   launchOptions->TreatAsUntrusted = true;

   // Launch the URI with a warning prompt
   concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri, launchOptions));
   launchUriOperation.then([](bool success)
   {
      if (success)
      {
         // URI launched
      }
      else
      {
         // URI launch failed
      }
   });
}

' The URI to launch
Dim uri As New Uri("http://www.bing.com")

async Sub DefaultLaunch()

   ' Set the option to show a warning
   Dim options = Windows.System.LauncherOptions()
   options.TreatAsUntrusted = True

   ' Launch the URI with a warning prompt
   Dim success = await Windows.System.Launcher.LaunchUriAsync(uri, options)

   If success Then
      ' URI launched
   Else
      ' URI launch failed
   End If

End Sub

설명

Windows 데스크톱 애플리케이션에서 이 API를 호출하지 않는 한 이 API는 ASTA 스레드(UI 스레드라고도 함) 내에서 호출되어야 합니다.

이 API는 Windows 데스크톱 애플리케이션에서도 호출할 수 있습니다.

이 API는 UWP(유니버설 Windows 플랫폼) 앱이든 Windows 데스크톱 애플리케이션이든 스키마에 대한 기본 앱을 시작합니다.

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

Windows 데스크톱 애플리케이션에서 이 API를 호출하지 않는 한 ASTA 스레드(UI 스레드라고도 함) 내에서 이 API를 호출해야 합니다.

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

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

콘텐츠 형식은 확장명에서 기본 앱이 선택된 파일 확장자를 계산하는 데 사용됩니다. 예를 들어 ""application/vnd.ms-word.document.12""의 콘텐츠 형식 값이 ".docx"에 매핑된 다음 ".docx"의 기본 애플리케이션이 시작됩니다. 예를 들어:

// this specifies the file type, which is used to bind to Word. 
launcherOptions.ContentType = "application/vnd.ms-word.document.12"; 
// and then this launches the file using the application
Launcher.LaunchUriAsync("http://www.cloud.com/file.docx", options);

위의 이유로 인해 시작이 실패하면 API가 성공하고 비동기 작업에서 FALSE를 반환합니다.

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

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

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

추가 정보

LaunchUriAsync(Uri)
LaunchUriAsync(Uri, LauncherOptions, ValueSet)
연결 시작 샘플
파일 형식 및 URI 대한 지침
URI 대한 기본 앱을 시작합니다.

적용 대상

LaunchUriAsync(Uri)

편집

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

public:
 static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri);

/// [Windows.Foundation.Metadata.Overload("LaunchUriAsync")]
 static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri);

[Windows.Foundation.Metadata.Overload("LaunchUriAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri);

function launchUriAsync(uri)

Public Shared Function LaunchUriAsync (uri As Uri) As IAsyncOperation(Of Boolean)

매개 변수

uri: Uri Uri

URI입니다.

반환

IAsyncOperation<Boolean>

IAsyncOperation<bool>

URI 스키마의 기본 앱이 시작된 경우 true 반환합니다. 그렇지 않으면 false .

특성: OverloadAttribute

예제

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

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

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

// Launch the URI
async void DefaultLaunch()
{
   // Launch the URI
   var success = await Windows.System.Launcher.LaunchUriAsync(uri);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

// The URI to launch.
Windows::Foundation::Uri m_uri{ L"http://www.bing.com" };
...
Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
    // Launch the URI.
    if (co_await Windows::System::Launcher::LaunchUriAsync(m_uri))
    {
        // URI launched.
    }
    else
    {
        // URI launch failed.
    }
}

// The URI to launch
auto uri = ref new Windows::Foundation::Uri("http://www.bing.com");

void MainPage::DefaultLaunch()
{
   // Launch the URI
   concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri));
   launchUriOperation.then([](bool success)
   {
      if (success)
      {
         // URI launched
      }
      else
      {
         // URI launch failed
      }
   });
}

' The URI to launch
Dim uri As New Uri("http://www.bing.com")

async Sub DefaultLaunch()

   ' Launch the URI
   Dim success = await Windows.System.Launcher.LaunchUriAsync(uri)

   If success Then
      ' URI launched
   Else
      ' URI launch failed
   End If

End Sub

설명

Windows 데스크톱 애플리케이션에서 이 API를 호출하지 않는 한 이 API는 ASTA 스레드(UI 스레드라고도 함) 내에서 호출되어야 합니다.

이 API는 Windows 데스크톱 애플리케이션에서도 호출할 수 있습니다.

이 API는 UWP(유니버설 Windows 플랫폼) 앱이든 Windows 데스크톱 애플리케이션이든 스키마에 대한 기본 앱을 시작합니다.

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

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

위의 이유로 인해 시작이 실패하면 API가 성공하고 비동기 작업에서 FALSE를 반환합니다.

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

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

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

추가 정보

LaunchUriAsync(Uri, LauncherOptions)
LaunchUriAsync(Uri, LauncherOptions, ValueSet)
연결 시작 샘플
파일 형식 및 URI 대한 지침
URI 대한 기본 앱을 시작합니다.

적용 대상

다음을 통해 공유

Launcher.LaunchUriAsync 메서드

정의

오버로드

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

매개 변수

반환

설명

추가 정보

적용 대상

LaunchUriAsync(Uri, LauncherOptions)

매개 변수

반환

예제

설명

추가 정보

적용 대상

LaunchUriAsync(Uri)

매개 변수

반환

예제

설명

추가 정보

적용 대상

피드백

추가 리소스