Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) Method

Startet die Standard-App, die der angegebenen Datei zugeordnet ist, unter Verwendung der angegebenen Optionen.

Syntax


Windows.System.Launcher.launchFileAsync(file, options).done( /* Erfolgs- und Fehlerhandler */ );

Parameter

file

Typ: IStorageFile

Die Datei.

options

Typ: LauncherOptions

Die Optionen zum Starten der App.

Rückgabewert

Typ: IAsyncOperation<Boolean>

Der Startvorgang.

Hinweise

Die aufrufende App muss für den Benutzer sichtbar sein, wenn die API aufgerufen wird.

Diese API erzwingt auch mehrere Einschränkungen bezüglich der zu startenden Dateitypen. Viel Dateitypen, die ausführbaren Code enthalten (beispielsweise EXE-, MSI- und JS-Dateien) sind für den Startvorgang blockiert. Diese Einschränkung schützt Benutzer vor potenziell schädlichen Dateien, die das System ändern könnten.

Wenn der Start aus einem der oben aufgeführten Gründe fehlschlägt, folgt die API und gibt FALSE durch ihren asynchronen Vorgang zurück. Da es keine Möglichkeit hat abzufragen, ob die oben genannten Einschränkungen für den aktuellen Start gelten, sollte die aufrufende App nicht davon ausgehen, dass der Start erfolgreich war und einen Fallbackmechanismus bereitstellen, für den Fall, dass der Start fehlgeschlagen ist. Eine mögliche Lösung besteht darin, den Benutzer aufzufordern, die Datei zu speichern, und den Benutzer anzuweisen, die Datei auf dem Desktop zu öffnen.

Um dem Benutzer das Auswählen einer App anstelle des Starten der Standard-App zu ermöglichen, legen Sie die LauncherOptions.DisplayApplicationPicker | displayApplicationPicker-Eigenschaft fest.

Um eine Warnung anzuzeigen, dass die Datei möglicherweise nicht sicher ist, legen Sie die LauncherOptions.TreatAsUntrusted | treatAsUntrusted-Eigenschaft fest.

Die Datei wird an die zugeordnete App übergeben. Wenn die zugeordnete App eine Desktop-App ist, wird die Datei mit den Shellausführungsmechanismen übergeben.

Windows Phone 8

Diese API wird nicht implementiert und löst beim Aufruf eine Ausnahme aus. Weitere Informationen finden Sie unter Windows Phone Runtime API.

Beispiele

Rufen Sie die Methode Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) auf, und setzen Sie die Eigenschaft LauncherOptions.DisplayApplicationPicker | displayApplicationPicker auf true, um die Anwendung zu starten, die der Benutzer für die Datei aus dem Dialogfeld Öffnen mit auswählt.



// Path to the file in the app package to launch
var imageFile = "images\\test.png";

// Get the image file from the package's image directory
Windows.ApplicationModel.Package.current.installedLocation.getFileAsync(imageFile).then(
  function (file) {
    // Set the show picker option
    var options = new Windows.System.LauncherOptions();
    options.displayApplicationPicker = true;

    // Launch the retrieved file using the selected app
    Windows.System.Launcher.launchFileAsync(file, options).then(
      function (success) {
        if (success) {
            // File launched
        } else {
            // File launch failed
        }
      });
  });

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Mindestens unterstütztes Telefon

Windows Phone 8 [nicht implementiert, siehe Hinweise]

Namespace

Windows.System
Windows::System [C++]

Metadaten

Windows.winmd

Siehe auch

Beispiele
Zuordnungsstartbeispiel
Richtlinien
Richtlinien und Prüfliste für Dateitypen und URIs
Aufgaben
Starten der Standard-App für eine Datei (JavaScript)
Starten der Standard-App für eine Datei (C#/VB/C++)
Verweis
Launcher
LaunchFileAsync(IStorageFile, LauncherOptions)

 

 

Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.