Partager via

LauncherOptions.FallbackUri Propriété

  • Référence

Définition

Espace de noms:
Windows.System
Modifier

Obtient ou définit une valeur qui représente un URI auquel l’utilisateur doit être dirigé dans le navigateur si aucune application n’existe pour gérer le type de fichier ou l’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

Valeur de propriété

Uri Uri

URI auquel l’utilisateur doit être dirigé dans le navigateur.

Exemples

Appelez la méthode Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) avec secoursUri défini sur l’URI de secours.

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

Remarques

Vous pouvez uniquement définir la propriété URI de secours avec http:// ou https:// URI. Si cette propriété est définie et qu’aucune application n’est installée pour gérer le fichier ou l’URI en cours de lancement, le navigateur par défaut de l’utilisateur est lancé automatiquement et accède à l’URI spécifié. L’utilisateur ne verra pas de boîte de dialogue Ouvrir avec demandant de choisir une option dans ce cas. Vous ne devez utiliser l’URI de secours que lorsque diriger l’utilisateur vers le Microsoft Store n’est pas approprié, par exemple lorsque le fichier ou l’URI est uniquement pris en charge par une application de bureau qui n’est pas répertoriée dans le Store. Dans tous les cas où il existe une application sur le Microsoft Store qui prend en charge le fichier ou l’URI que vous lancez, vous devez utiliser PreferredApplicationPackageFamilyName et PreferredApplicationDisplayName pour recommander cette application à l’utilisateur.

Vous ne pouvez pas définir les propriétés d’application préférées et l’URI de secours en même temps, car un seul secours peut être utilisé. L’API Launcher échoue si les deux secours sont définis.

Windows 8.1 Dans Windows 8.1 uniquement, cette propriété accepte également les URI du Microsoft Store. Ces URI peuvent être utilisés comme alternative aux propriétés PreferredApplicationPackageFamilyName et PreferredApplicationDisplayName pour envoyer l’utilisateur à une application spécifique dans le Windows Store sans ouvrir une boîte de dialogue Ouvrir avec . Cette fonctionnalité n’est pas prise en charge sur les applications Windows Phone 8.1 ou convergées Windows 10, et son utilisation n’est pas recommandée.

S’applique à

Voir aussi