LauncherOptions.FallbackUri 属性

定义

获取或设置一个值,该值表示在不存在处理文件类型或 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。

示例

调用 Launcher.LaunchFileAsync (IStorageFile、LauncherOptions) | launchFileAsync (IStorageFile,LauncherOptions) 方法,并将 fallbackUri 设置为回退 URI。

// 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

注解

只能使用 http:// 或 https:// URI 设置回退 URI 属性。 如果设置了此属性,并且没有安装应用来处理正在启动的文件或 URI,则用户的默认浏览器将自动启动并导航到指定的 URI。 在这种情况下,用户将看不到要求选择选项的“ 打开方式 ”对话框。 仅当将用户定向到 Microsoft Store 不合适时,才应使用回退 URI,例如文件或 URI 仅受应用商店中未列出的桌面应用支持的情况。 在 Microsoft Store 上存在支持要启动的文件或 URI 的应用的所有情况下,都应使用 PreferredApplicationPackageFamilyNamePreferredApplicationDisplayName 向用户推荐该应用。

不能同时设置首选应用程序属性和回退 URI,因为只能使用一个回退。 如果设置了两个回退,启动器 API 将失败。

Windows 8.1 仅在 Windows 8.1 中,此属性还接受 Microsoft Store URI。 这些 URI 可用作 PreferredApplicationPackageFamilyNamePreferredApplicationDisplayName 属性的替代方法,以将用户发送到应用商店中的特定应用,而不会弹出 “打开方式 ”对话框。 Windows Phone 8.1 或聚合Windows 10应用不支持此功能,不建议使用此功能。

适用于

另请参阅