Launcher Classe

Definizione

Spazio dei nomi:

Windows.System

Avvia l'app predefinita associata al file o all'URI specificato.

public ref class Launcher abstract sealed

/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Launcher

Public Class Launcher

Ereditarietà

Object Platform::Object IInspectable Launcher

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Avviare un file contenuto nel pacchetto dell'app

Vedere l'esempio di codice nell'argomento LaunchFileAsync(IStorageFile).

Avviare un URI

Vedere l'esempio di codice nell'argomento LaunchUriAsync(Uri).

Avviare con una finestra di dialogo di avviso

Questo esempio chiama launchUriAsync(Uri, LauncherOptions) per avviare un URI con un avviso. Utilizzare la proprietà treatAsUntrusted per indicare che il sistema deve visualizzare un avviso.

Nota

Per un'app di Windows che usa JavaScript, chiamare preventDefault nel gestore eventi se la proprietà treatAsUntrusted è impostata e si usa un elemento di ancoraggio per avviare l'URI.

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
                    }
                });
        }
    }
}

Commenti

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX) e Uso di oggetti Windows Runtime in un ambiente multithreading (.NET).

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
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)

Metodi

FindAppUriHandlersAsync(Uri)	Enumerare i gestori URI (Uniform Resource Identifier) nel dispositivo.
FindFileHandlersAsync(String)	Enumerare i gestori di file nel dispositivo.
FindUriSchemeHandlersAsync(String)	Enumerare i gestori dello schema nel dispositivo.
FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)	Enumerare i gestori dello schema nel dispositivo.
LaunchFileAsync(IStorageFile)	Avvia l'app predefinita associata al file specificato.
LaunchFileAsync(IStorageFile, LauncherOptions)	Avvia l'app predefinita associata al file specificato, usando le opzioni specificate.
LaunchFolderAsync(IStorageFolder)	Avvia Esplora file e visualizza il contenuto della cartella specificata.
LaunchFolderAsync(IStorageFolder, FolderLauncherOptions)	Avvia Esplora file con le opzioni specificate e visualizza il contenuto della cartella specificata.
LaunchFolderPathAsync(String)	Avvia Esplora file e visualizza il contenuto della cartella specificata.
LaunchFolderPathAsync(String, FolderLauncherOptions)	Avvia Esplora file con le opzioni specificate e visualizza il contenuto della cartella specificata.
LaunchFolderPathForUserAsync(User, String)	Avvia Esplora file e visualizza il contenuto della cartella specificata.
LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions)	Avvia Esplora file con le opzioni specificate e visualizza il contenuto della cartella specificata.
LaunchUriAsync(Uri)	Avvia l'app predefinita associata al nome dello schema URI per l'URI specificato.
LaunchUriAsync(Uri, LauncherOptions)	Avvia l'app predefinita associata al nome dello schema URI o a quella specificata da ContentType per l'URI specificato, usando le opzioni specificate.
LaunchUriAsync(Uri, LauncherOptions, ValueSet)	Avvia l'app predefinita associata al nome dello schema URI per l'URI specificato, usando le opzioni e i dati di input specificati.
LaunchUriForResultsAsync(Uri, LauncherOptions)	Avvia in modo asincrono l'app predefinita associata al nome dello schema URI per l'URI specificato, usando le opzioni specificate.
LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)	Avvia in modo asincrono l'app predefinita associata al nome dello schema URI per l'URI specificato, usando le opzioni e i dati di input specificati.
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)	Avvia in modo asincrono l'app predefinita associata al nome dello schema URI per l'URI specificato usando le opzioni specificate e fornisce un utente specifico come contesto.
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)	Avvia in modo asincrono l'app predefinita associata al nome dello schema URI per l'URI specificato usando le opzioni e i dati di input specificati e fornisce un utente specifico come contesto.
LaunchUriForUserAsync(User, Uri)	Avvia l'app multiutente predefinita associata al nome dello schema URI per l'URI specificato e fornisce un utente specifico come contesto.
LaunchUriForUserAsync(User, Uri, LauncherOptions)	Avvia l'app multiutente predefinita associata al nome dello schema URI per l'URI specificato usando le opzioni specificate e fornisce un utente specifico come contesto.
LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)	Avvia l'app multiutente predefinita associata al nome dello schema URI per l'URI specificato, usando le opzioni e i dati di input specificati e fornisce un utente specifico come contesto.
QueryAppUriSupportAsync(Uri)	Eseguire una query asincrona se è presente un'app in grado di gestire l'URI specificato.
QueryAppUriSupportAsync(Uri, String)	Eseguire una query asincrona se l'app specificata può gestire l'URI specificato.
QueryFileSupportAsync(StorageFile)	Eseguire una query asincrona per verificare se un'app può essere attivata per il file specificato.
QueryFileSupportAsync(StorageFile, String)	Eseguire una query asincrona per verificare se un'app con il nome del pacchetto specificato può essere attivata per il file specificato.
QueryUriSupportAsync(Uri, LaunchQuerySupportType)	Eseguire una query asincrona per verificare se un'app può essere attivata per l'URI e il tipo di avvio specificati.
QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)	Eseguire una query asincrona per verificare se un'app può essere attivata per l'URI, il tipo di avvio e il nome del pacchetto specificati.

Vedi anche

• LauncherOptions
• LauncherUIOptions
• Avviare l'app predefinita per un file
• Avviare l'app predefinita per un URI
• Esempio di avvio di associazione
• Linee guida per tipi di file e URI