Launcher Klasse

Referenz

Definition

Namespace:: Windows.System

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Startet die Standard-App, die der angegebenen Datei oder dem 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 IInspectable Launcher

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 Datei im App-Paket

Siehe das Codebeispiel im LaunchFileAsync(IStorageFile) Thema.

Starten eines URI

Siehe das Codebeispiel im LaunchUriAsync(Uri) Thema.

Starten mit einem Warnungsdialogfeld

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

Hinweis

Rufen Sie für eine Windows-App mit JavaScript die VerhinderungDefault in Ihrem Ereignishandler auf, wenn die Eigenschaft festgelegt ist und Sie ein Ankerelement verwenden, um den treatAsUntrusted 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 agile, was bedeutet, dass Sie das Threadingmodell und das Marshalingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) and 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, Uniform Resource Identifiers) auf dem Gerät.
FindFileHandlersAsync(String)	Aufzählen sie die Dateihandler auf dem Gerät.
FindUriSchemeHandlersAsync(String)	Aufzählen sie die Schemahandler auf dem Gerät.
FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)	Aufzählen sie die 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, mithilfe 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 oder dem ContentType für den angegebenen URI angegebenen Schemanamen zugeordnet ist, wobei die angegebenen Optionen verwendet werden.
LaunchUriAsync(Uri, LauncherOptions, ValueSet)	Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, wobei die angegebenen Optionen und Eingabedaten verwendet werden.
LaunchUriForResultsAsync(Uri, LauncherOptions)	Startet asynchron die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, mithilfe der angegebenen Optionen.
LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)	Startet asynchron die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, mithilfe der angegebenen Optionen und Eingabedaten.
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)	Startet asynchron die Standard-App, die dem URI-Schemanamen für den angegebenen URI mit den angegebenen Optionen zugeordnet ist, und stellt einen bestimmten User Kontext bereit.
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)	Startet asynchron die Standard-App, die dem URI-Schemanamen für den angegebenen URI mit den angegebenen Optionen und Eingabedaten zugeordnet ist, und stellt einen bestimmten User Kontext bereit.
LaunchUriForUserAsync(User, Uri)	Startet die standardmäßige Multi-User-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist und einen bestimmten User Kontext bereitstellt.
LaunchUriForUserAsync(User, Uri, LauncherOptions)	Startet die standardmäßige Multi-User-App, die dem URI-Schemanamen für den angegebenen URI mit den angegebenen Optionen zugeordnet ist, und stellt einen bestimmten User Kontext bereit.
LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)	Startet die standardmäßige Multi-User-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, wobei die angegebenen Optionen und Eingabedaten verwendet werden, und stellt einen bestimmten User Kontext bereit.
QueryAppUriSupportAsync(Uri)	Asynchron abfragen, ob eine App vorhanden ist, die den angegebenen URI behandeln kann.
QueryAppUriSupportAsync(Uri, String)	Asynchron abfragen, ob die angegebene App den angegebenen URI verarbeiten kann.
QueryFileSupportAsync(StorageFile)	Asynchron abfragen, ob eine App für die angegebene Datei aktiviert werden kann.
QueryFileSupportAsync(StorageFile, String)	Asynchron abfragen, 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 den Starttyp aktiviert werden kann.
QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)	Asynchron abfragen, ob eine App für den angegebenen URI, den Starttyp und den Paketnamen aktiviert werden kann.

Gilt für: