LauncherOptions.FallbackUri Eigenschaft

  • Referenz

Definition

Namespace:
Windows.System
Bearbeiten

Ruft einen Wert ab, der einen URI darstellt, zu dem der Benutzer im Browser weitergeleitet werden soll, wenn keine App vorhanden ist, um den Dateityp oder den URI zu behandeln, oder legt diesen fest.

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

Eigenschaftswert

Uri Uri

URI, zu dem der Benutzer im Browser weitergeleitet werden soll.

Beispiele

Rufen Sie die Methode Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) auf, wobei fallbackUri auf den Fallback-URI festgelegt ist.

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

Hinweise

Sie können die Fallback-URI-Eigenschaft nur mit http:// oder https://-URI festlegen. Wenn diese Eigenschaft festgelegt ist und keine App installiert ist, um die gestartete Datei oder den URI zu verarbeiten, wird der Standardbrowser des Benutzers automatisch gestartet und zum angegebenen URI navigiert. In diesem Fall wird dem Benutzer kein Dialogfeld Öffnen mit angezeigt, in dem aufgefordert wird, eine Option auszuwählen. Sie sollten den Fallback-URI nur verwenden, wenn das Weiterleiten des Benutzers zum Microsoft Store nicht geeignet ist, z. B. wenn die Datei oder der URI nur von einer Desktop-App unterstützt wird, die nicht im Store aufgeführt ist. In allen Fällen, in denen im Microsoft Store eine App vorhanden ist, die die Datei oder den URI unterstützt, die Sie starten, sollten Sie die Option PreferredApplicationPackageFamilyName und PreferredApplicationDisplayName verwenden, um diese App dem Benutzer zu empfehlen.

Sie können die bevorzugten Anwendungseigenschaften und den Fallback-URI nicht gleichzeitig festlegen, da nur ein Fallback verwendet werden kann. Die Startprogramm-API schlägt fehl, wenn beide Fallbacks festgelegt sind.

Windows 8.1 Nur in Windows 8.1 akzeptiert diese Eigenschaft auch Microsoft Store-URIs. Diese URIs können als Alternative zu den Eigenschaften PreferredApplicationPackageFamilyName und PreferredApplicationDisplayName verwendet werden, um den Benutzer an eine bestimmte App im Store zu senden, ohne das Dialogfeld Öffnen mit zu öffnen. Diese Funktionalität wird in Windows Phone 8.1- oder konvergenten Windows 10-Apps nicht unterstützt, und die Verwendung wird nicht empfohlen.

Gilt für:

Weitere Informationen