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

アプリの起動オプション。

inputData: ValueSet

アプリの入力データ。

重要

転送できるデータの量は、100 KB を超えてはなりません。

戻り値

IAsyncOperation<Boolean>

IAsyncOperation<bool>

URI スキームの既定のアプリが起動された場合は true を返します。それ以外の場合 は false 。

属性: OverloadAttribute

注釈

Windows デスクトップアプリケーションからこの API を呼び出す場合を除き、この API は ASTA スレッド (UI スレッドとも呼ばれます) 内から呼び出す必要があります。

この API は、Windows デスクトップアプリケーションから呼び出すこともできます。

この API は、ユニバーサル Windows プラットフォーム (UWP) アプリまたは 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

注釈

この API は、Windows デスクトップアプリケーションから呼び出すこともできます。

呼び出し元のアプリは、この API が呼び出されたときにユーザーに表示される必要があります。

イントラネット URI (ネットワークの場所を指す file:/// URI など) を起動するには、マニフェストで privateNetworkClientServer 機能を指定する必要があります。

このメソッドを使用して、ローカルゾーンで URI を起動することはできません。たとえば、アプリでは 、file:/// プロトコルを使用してローカルコンピューター上のファイルにアクセスすることはできません。代わりに、ストレージ 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)

編集

指定した 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

注釈

この API は、Windows デスクトップアプリケーションから呼び出すこともできます。

呼び出し元のアプリは、API が呼び出されたときにユーザーに表示される必要があります。

上記のいずれかの理由で起動が失敗すると、API は成功し、非同期操作から FALSE を返します。

ユーザーが既定のアプリを起動する代わりにアプリを選択できるようにするには、 LauncherOptions.DisplayApplicationPicker プロパティを設定します。

URI が安全でない可能性があることを示す警告を表示するには、 LauncherOptions.TreatAsUntrusted プロパティを設定します。

こちらもご覧ください

適用対象

Launcher.LaunchUriAsync メソッド

定義

オーバーロード

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

パラメーター

戻り値

注釈

こちらもご覧ください

適用対象

LaunchUriAsync(Uri, LauncherOptions)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

LaunchUriAsync(Uri)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

フィードバック

フィードバック

その他のリソース