LauncherOptions.FallbackUri プロパティ

  • リファレンス

定義

名前空間:
Windows.System
編集

ファイルの種類または URI を処理するアプリが存在しない場合に、ブラウザーでユーザーが取得する URI を表す値を取得または設定します。

public:
 property Uri ^ FallbackUri { Uri ^ get(); void set(Uri ^ value); };
Uri FallbackUri();

void FallbackUri(Uri value);
public System.Uri FallbackUri { get; set; }
var uri = launcherOptions.fallbackUri;
launcherOptions.fallbackUri = uri;
Public Property FallbackUri As Uri

プロパティ値

Uri Uri

ブラウザーでユーザーを取得する必要がある URI。

例

fallbackUri をフォールバック URI に設定して Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) メソッドを呼び出します。

// The URI to launch
string uriToLaunch = @ "contoso:somearguments";
var uri = new Uri(uriToLaunch);

// The fallback URI
string uriFallback = @ "http://www.contoso.com/somearguments";
var fallbackUri = new Uri(fallbackUri);

async void DefaultLaunch()
{
   // Set the fallback URI
   var options = new Windows.System.LauncherOptions();
   options.FallbackUri = fallbackUri;

   // Launch the URI with the fallback URI
   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"contoso:somearguments" };

// The fallback URI.
Windows::Foundation::Uri m_fallbackUri{ L"http://www.contoso.com/somearguments" };

Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
    // Set the fallback URI.
    Windows::System::LauncherOptions launcherOptions;
    launcherOptions.FallbackUri(m_fallbackUri);

    // 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("contoso:somearguments");

// The fallback URI
auto fallbackUri = ref new Windows::Foundation::Uri("http://www.contoso.com/somearguments");

void MainPage::DefaultLaunch()
{
   // Set the fallback URI
   auto launchOptions = ref new Windows::System::LauncherOptions();
   launchOptions->FallbackUri = fallbackUri;

   // Launch the URI with the fallback URI
   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("contoso:somearguments")

' The fallback URI
Dim fallbackUri As New Uri("http://www.contoso.com/somearguments")

async Sub DefaultLaunch()

   ' Set the fallback URI
   Dim options = Windows.System.LauncherOptions()
   options.FallbackUri = fallbackUri

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

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

End Sub

注釈

フォールバック URI プロパティは、http:// または https:// URI でのみ設定できます。 このプロパティが設定されていて、起動中のファイルまたは URI を処理するアプリがインストールされていない場合、ユーザーの既定のブラウザーが自動的に起動され、指定した URI に移動します。 この場合、ユーザーにオプションの選択を求める [ 開く ] ダイアログは表示されません。 ユーザーを Microsoft Store に誘導する場合にのみフォールバック URI を使用する必要があります。たとえば、ファイルまたは URI がストアに一覧表示されていないデスクトップ アプリでのみサポートされている場合などです。 起動するファイルまたは URI をサポートするアプリが Microsoft Store に存在するすべての場合は、 PreferredApplicationPackageFamilyName と PreferredApplicationDisplayName を使用して、そのアプリをユーザーに推奨する必要があります。

1 つのフォールバックしか使用できないため、優先アプリケーションのプロパティとフォールバック URI を同時に設定することはできません。 両方のフォールバックが設定されている場合、Launcher API は失敗します。

Windows 8.1 Windows 8.1のみ、このプロパティは Microsoft Store URI も受け入れます。 これらの URI は、 PreferredApplicationPackageFamilyName プロパティと PreferredApplicationDisplayName プロパティの代わりに使用して、[ Open With ] ダイアログをポップせずに、ストア内の特定のアプリにユーザーを送信できます。 この機能は、Windows Phone 8.1 またはコンバージド Windows 10 アプリではサポートされていないため、その使用は推奨されません。

適用対象

こちらもご覧ください