Launcher Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicia la aplicación predeterminada asociada al archivo o URI especificados.
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 LauncherPublic Class Launcher- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Ejemplos
Inicio de un archivo incluido en el paquete de la aplicación
Consulte el ejemplo de código en el tema LaunchFileAsync(IStorageFile).
Inicio de un URI
Consulte el ejemplo de código en el tema LaunchUriAsync(Uri).
Iniciar con un cuadro de diálogo de advertencia
En este ejemplo se llama a launchUriAsync(Uri, LauncherOptions) para iniciar un URI con una advertencia. Utilice la propiedad treatAsUntrusted para indicar que el sistema debe mostrar una advertencia.
Nota
Para una aplicación de Windows con JavaScript, llame a preventDefault en el controlador de eventos si se establece la propiedad treatAsUntrusted y usa un elemento de delimitador para iniciar el 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
}
});
}
}
}
Comentarios
Nota
Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, vea Subprocesos y serialización (C++/CX) y Uso de objetos Windows Runtime en un entorno multiproceso (.NET).
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 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) |
Métodos
| FindAppUriHandlersAsync(Uri) |
Enumerar los controladores de identificadores uniformes de recursos (URI) en el dispositivo. |
| FindFileHandlersAsync(String) |
Enumere los controladores de archivos en el dispositivo. |
| FindUriSchemeHandlersAsync(String) |
Enumerar los controladores de esquema en el dispositivo. |
| FindUriSchemeHandlersAsync(String, LaunchQuerySupportType) |
Enumerar los controladores de esquema en el dispositivo. |
| LaunchFileAsync(IStorageFile) |
Inicia la aplicación predeterminada asociada al archivo especificado. |
| LaunchFileAsync(IStorageFile, LauncherOptions) |
Inicia la aplicación predeterminada asociada al archivo especificado mediante las opciones especificadas. |
| LaunchFolderAsync(IStorageFolder) |
Inicia Explorador de archivos y muestra el contenido de la carpeta especificada. |
| LaunchFolderAsync(IStorageFolder, FolderLauncherOptions) |
Inicia Explorador de archivos con las opciones especificadas y muestra el contenido de la carpeta especificada. |
| LaunchFolderPathAsync(String) |
Inicia Explorador de archivos y muestra el contenido de la carpeta especificada. |
| LaunchFolderPathAsync(String, FolderLauncherOptions) |
Inicia Explorador de archivos con las opciones especificadas y muestra el contenido de la carpeta especificada. |
| LaunchFolderPathForUserAsync(User, String) |
Inicia Explorador de archivos y muestra el contenido de la carpeta especificada. |
| LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions) |
Inicia Explorador de archivos con las opciones especificadas y muestra el contenido de la carpeta especificada. |
| LaunchUriAsync(Uri) |
Inicia la aplicación predeterminada asociada al nombre del esquema de URI para el URI especificado. |
| LaunchUriAsync(Uri, LauncherOptions) |
Inicia la aplicación predeterminada asociada al nombre del esquema de URI o la especificada por contentType para el URI especificado, utilizando las opciones especificadas. |
| LaunchUriAsync(Uri, LauncherOptions, ValueSet) |
Inicia la aplicación predeterminada asociada al nombre de esquema de URI para el URI especificado, utilizando las opciones y los datos de entrada especificados. |
| LaunchUriForResultsAsync(Uri, LauncherOptions) |
Inicia de forma asincrónica la aplicación predeterminada asociada al nombre de esquema de URI para el URI especificado, utilizando las opciones especificadas. |
| LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet) |
Inicia de forma asincrónica la aplicación predeterminada asociada al nombre de esquema de URI para el URI especificado, utilizando las opciones y los datos de entrada especificados. |
| LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions) |
Inicia de forma asincrónica la aplicación predeterminada asociada al nombre de esquema de URI para el URI especificado mediante las opciones especificadas y proporciona un usuario específico como contexto. |
| LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet) |
Inicia de forma asincrónica la aplicación predeterminada asociada al nombre del esquema de URI para el URI especificado mediante las opciones y los datos de entrada especificados, y proporciona un usuario específico como contexto. |
| LaunchUriForUserAsync(User, Uri) |
Inicia la aplicación multiusuario predeterminada asociada al nombre de esquema de URI para el URI especificado y proporciona un usuario específico como contexto. |
| LaunchUriForUserAsync(User, Uri, LauncherOptions) |
Inicia la aplicación multiusuario predeterminada asociada al nombre de esquema de URI para el URI especificado mediante las opciones especificadas y proporciona un usuario específico como contexto. |
| LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet) |
Inicia la aplicación multiusuario predeterminada asociada al nombre de esquema de URI para el URI especificado, utilizando las opciones y los datos de entrada especificados, y proporciona un usuario específico como contexto. |
| QueryAppUriSupportAsync(Uri) |
Consulte de forma asincrónica si hay una aplicación que puede controlar el URI especificado. |
| QueryAppUriSupportAsync(Uri, String) |
Consulte de forma asincrónica si la aplicación especificada puede controlar el URI especificado. |
| QueryFileSupportAsync(StorageFile) |
Consulte de forma asincrónica si se puede activar una aplicación para el archivo especificado. |
| QueryFileSupportAsync(StorageFile, String) |
Consulte de forma asincrónica si se puede activar una aplicación con el nombre de paquete especificado para el archivo especificado. |
| QueryUriSupportAsync(Uri, LaunchQuerySupportType) |
Consulte de forma asincrónica si se puede activar una aplicación para el URI y el tipo de inicio especificados. |
| QueryUriSupportAsync(Uri, LaunchQuerySupportType, String) |
Consulte de forma asincrónica si se puede activar una aplicación para el URI, el tipo de inicio y el nombre del paquete especificados. |