Condividi tramite


Launcher Classe

Definizione

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)]
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
Ereditarietà
Object Platform::Object IInspectable Launcher
Attributi

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.

Si applica a

Vedi anche