Condividi tramite

LauncherOptions.FallbackUri Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
Windows.System
Modifica

Ottiene o imposta un valore che rappresenta un URI che l'utente deve essere impiegato nel browser se non esiste alcuna app per gestire il tipo di file o 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

Valore della proprietà

Uri Uri

URI che l'utente deve essere impiegato nel browser.

Esempio

Chiamare il metodo Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) con fallbackUri impostato sull'URI di fallback.

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

Commenti

È possibile impostare solo la proprietà URI di fallback con http:// o https:// URI. Se questa proprietà è impostata e non è installata alcuna app per gestire il file o l'URI avviato, il browser predefinito dell'utente viene avviato automaticamente e spostato sull'URI specificato. L'utente non visualizzerà una finestra di dialogo Apri con che chiede di scegliere un'opzione in questo caso. È consigliabile usare solo l'URI di fallback quando si indirizza l'utente a Microsoft Store non è appropriato, ad esempio nel caso in cui il file o l'URI sia supportato solo da un'app desktop non elencata nello Store. In tutti i casi in cui è presente un'app in Microsoft Store che supporta il file o l'URI che si sta avviando, è consigliabile usare PreferredApplicationPackageFamilyName e PreferredApplicationDisplayName per consigliare l'app all'utente.

Non è possibile impostare le proprietà dell'applicazione preferite e l'URI di fallback contemporaneamente, poiché è possibile usare un solo fallback. L'API Launcher avrà esito negativo se vengono impostati entrambi i fallback.

Windows 8.1 Solo in Windows 8.1, questa proprietà accetta anche gli URI di Microsoft Store. Questi URI possono essere usati come alternativa alle proprietà PreferredApplicationPackageFamilyName e PreferredApplicationDisplayName per inviare l'utente a un'app specifica nello Store senza aprire una finestra di dialogo Open With. Questa funzionalità non è supportata in Windows Phone 8.1 o nelle app Windows 10 convergenti e l'uso non è consigliato.

Si applica a

Vedi anche