Freigeben über


Launcher Klasse

Definition

Startet die Standard-App, die der angegebenen Datei oder dem angegebenen URI zugeordnet ist.

public ref class Launcher abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class Launcher final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Launcher final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public static class Launcher
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Launcher
Public Class Launcher
Vererbung
Object Platform::Object IInspectable Launcher
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Starten einer im App-Paket enthaltenen Datei

Weitere Informationen finden Sie im Codebeispiel im Thema LaunchFileAsync(IStorageFile).

Starten eines URI

Weitere Informationen finden Sie im Codebeispiel im Thema LaunchUriAsync(Uri).

Starten mit einem Warnungsdialogfeld

In diesem Beispiel wird launchUriAsync(Uri, LauncherOptions) aufgerufen, um einen URI mit einer Warnung zu starten. Verwenden Sie die treatAsUntrusted-Eigenschaft , um anzugeben, dass das System eine Warnung anzeigen soll.

Hinweis

Rufen Sie für eine Windows-App, die JavaScript verwendet, preventDefault in Ihrem Ereignishandler auf, wenn die treatAsUntrusted-Eigenschaft festgelegt ist und Sie ein Ankerelement verwenden, um den URI zu starten.

function linkClickHandler(eventInfo) {
    var link = eventInfo.target;
    if (eventInfo.srcElement && (
        (eventInfo.type === "click") ||
        (eventInfo.type === "keydown" && (
        eventInfo.keyCode === WinJS.Utilities.Key.enter ||
        eventInfo.keyCode === WinJS.Utilities.Key.space)))) {
        eventInfo.preventDefault();
        if (link.href.indexOf("ms-appx") > -1) {
            WinJS.Navigation.navigate(link.href);
        }
        else if (link.href.indexOf("http") > -1) {
            // Create a Uri object from a URI string 
            var uri = new Windows.Foundation.Uri(link.href);
            var options = new Windows.System.LauncherOptions();
            // Launch the URI with a warning prompt
            options.treatAsUntrusted = true;
            // Launch the URI
            Windows.System.Launcher.launchUriAsync(uri, options).then(
                function (success) {
                    if (success) {
                        // URI launched
                    } else {
                        // URI launch failed
                    }
                });
        }
    }
}

Hinweise

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1607 14393 FindAppUriHandlersAsync
1607 14393 LaunchUriForResultsForUserAsync(User,Uri,LauncherOptions)
1607 14393 LaunchUriForResultsForUserAsync(User,Uri,LauncherOptions,ValueSet)
1607 14393 LaunchUriForUserAsync(User,Uri)
1607 14393 LaunchUriForUserAsync(User,Uri,LauncherOptions)
1607 14393 LaunchUriForUserAsync(User,Uri,LauncherOptions,ValueSet)
1607 14393 QueryAppUriSupportAsync(Uri)
1607 14393 QueryAppUriSupportAsync(Uri,String)
1809 17763 LaunchFolderPathAsync(String)
1809 17763 LaunchFolderPathAsync(String,FolderLauncherOptions)
1809 17763 LaunchFolderPathForUserAsync(User,String)
1809 17763 LaunchFolderPathForUserAsync(User,String,FolderLauncherOptions)

Methoden

FindAppUriHandlersAsync(Uri)

Auflisten der URI-Handler (Uniform Resource Identifiers) auf dem Gerät.

FindFileHandlersAsync(String)

Auflisten der Dateihandler auf dem Gerät.

FindUriSchemeHandlersAsync(String)

Auflisten der Schemahandler auf dem Gerät.

FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)

Auflisten der Schemahandler auf dem Gerät.

LaunchFileAsync(IStorageFile)

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

LaunchFileAsync(IStorageFile, LauncherOptions)

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

LaunchFolderAsync(IStorageFolder)

Startet Explorer und zeigt den Inhalt des angegebenen Ordners an.

LaunchFolderAsync(IStorageFolder, FolderLauncherOptions)

Startet Explorer mit den angegebenen Optionen und zeigt den Inhalt des angegebenen Ordners an.

LaunchFolderPathAsync(String)

Startet Explorer und zeigt den Inhalt des angegebenen Ordners an.

LaunchFolderPathAsync(String, FolderLauncherOptions)

Startet Explorer mit den angegebenen Optionen und zeigt den Inhalt des angegebenen Ordners an.

LaunchFolderPathForUserAsync(User, String)

Startet Explorer und zeigt den Inhalt des angegebenen Ordners an.

LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions)

Startet Explorer mit den angegebenen Optionen und zeigt den Inhalt des angegebenen Ordners an.

LaunchUriAsync(Uri)

Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist.

LaunchUriAsync(Uri, LauncherOptions)

Startet die Standard-App, die dem URI-Schemanamen zugeordnet ist, oder die vom ContentType für den angegebenen URI angegebene App unter Verwendung der angegebenen Optionen.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, unter Verwendung der angegebenen Optionen und Eingabedaten.

LaunchUriForResultsAsync(Uri, LauncherOptions)

Startet die Standard-App, die dem Namen des URI-Schemas für den angegebenen URI zugeordnet ist, unter Verwendung der angegebenen Optionen asynchron.

LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)

Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, unter Verwendung der angegebenen Optionen und Eingabedaten asynchron.

LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)

Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, mithilfe der angegebenen Optionen asynchron und stellt einen bestimmten Benutzer als Kontext bereit.

LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)

Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, mithilfe der angegebenen Optionen und Eingabedaten asynchron und stellt einen bestimmten Benutzer als Kontext bereit.

LaunchUriForUserAsync(User, Uri)

Startet die Standard-App mit mehreren Benutzern, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, und stellt einen bestimmten Benutzer als Kontext bereit.

LaunchUriForUserAsync(User, Uri, LauncherOptions)

Startet die standardmäßige Mehrbenutzer-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, unter Verwendung der angegebenen Optionen und stellt einen bestimmten Benutzer als Kontext bereit.

LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)

Startet die standardmäßige Mehrbenutzer-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, unter Verwendung der angegebenen Optionen und Eingabedaten und stellt einen bestimmten Benutzer als Kontext bereit.

QueryAppUriSupportAsync(Uri)

Fragen Sie asynchron ab, ob eine App vorhanden ist, die den angegebenen URI verarbeiten kann.

QueryAppUriSupportAsync(Uri, String)

Fragen Sie asynchron ab, ob die angegebene App den angegebenen URI verarbeiten kann.

QueryFileSupportAsync(StorageFile)

Fragen Sie asynchron ab, ob eine App für die angegebene Datei aktiviert werden kann.

QueryFileSupportAsync(StorageFile, String)

Fragen Sie asynchron ab, ob eine App mit dem angegebenen Paketnamen für die angegebene Datei aktiviert werden kann.

QueryUriSupportAsync(Uri, LaunchQuerySupportType)

Fragen Sie asynchron ab, ob eine App für den angegebenen URI und starttyp aktiviert werden kann.

QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)

Fragen Sie asynchron ab, ob eine App für den angegebenen URI, Starttyp und Paketnamen aktiviert werden kann.

Gilt für:

Weitere Informationen