Поделиться через

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, который пользователь должен получить в браузере.

Примеры

Вызовите метод Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) с резервным 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

Комментарии

Свойство резервного URI можно задать только с помощью http:// или https:// URI. Если это свойство задано и не установлено приложение для обработки запускаемого файла или URI, браузер пользователя по умолчанию запускается автоматически и переходит к указанному URI. В этом случае пользователь не увидит диалоговое окно "Открыть с помощью " с запросом на выбор параметра. Резервный URI следует использовать только в том случае, если направление пользователя в Microsoft Store не подходит, например, если файл или URI поддерживаются только классическим приложением, которое не указано в Магазине. Во всех случаях, когда в Microsoft Store есть приложение, поддерживающее запускаемый файл или URI, следует использовать PreferredApplicationPackageFamilyName и PreferredApplicationDisplayName , чтобы рекомендовать это приложение пользователю.

Вы не можете одновременно задать предпочитаемые свойства приложения и резервный URI, так как можно использовать только один резервный вариант. Если заданы оба резервных варианта, API средства запуска завершится ошибкой.

Windows 8.1 Только в Windows 8.1 это свойство также принимает URI Microsoft Store. Эти URI можно использовать в качестве альтернативы свойствам PreferredApplicationPackageFamilyName и PreferredApplicationDisplayName для отправки пользователя в определенное приложение в Магазине без открытия диалогового окна Открыть с помощью. Эта функция не поддерживается в Windows Phone 8.1 или конвергентных приложениях Windows 10, и ее использование не рекомендуется.

Применяется к

См. также раздел