Launcher.LaunchUriAsync Método
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í.
Sobrecargas
| 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. |
| 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) |
Inicia la aplicación predeterminada asociada al nombre del esquema de URI para el URI especificado. |
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.
public:
static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri, LauncherOptions ^ options, ValueSet ^ inputData);/// [Windows.Foundation.Metadata.Overload("LaunchUriWithDataAsync")]
static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri, LauncherOptions const& options, ValueSet const& inputData);[Windows.Foundation.Metadata.Overload("LaunchUriWithDataAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri, LauncherOptions options, ValueSet inputData);function launchUriAsync(uri, options, inputData)Public Shared Function LaunchUriAsync (uri As Uri, options As LauncherOptions, inputData As ValueSet) As IAsyncOperation(Of Boolean)Parámetros
- options
- LauncherOptions
Las opciones de inicio de la aplicación.
- inputData
- ValueSet
Los datos de entrada de la aplicación.
Importante
La cantidad de datos que se pueden transferir no debe superar los 100 KB.
Devoluciones
Devuelve true si se inició la aplicación predeterminada para el esquema URI; False en caso contrario.
- Atributos
Comentarios
A menos que llame a esta API desde una aplicación de escritorio de Windows, se debe llamar a esta API desde un subproceso de ASTA (también conocido como subproceso de interfaz de usuario).
También se puede llamar a esta API desde una aplicación de escritorio de Windows.
Esta API inicia la aplicación predeterminada para el esquema, ya sea una aplicación de Plataforma universal de Windows (UWP) o una aplicación de escritorio de Windows.
Consulte también
Se aplica a
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.
public:
static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri, LauncherOptions ^ options);/// [Windows.Foundation.Metadata.Overload("LaunchUriWithOptionsAsync")]
static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri, LauncherOptions const& options);[Windows.Foundation.Metadata.Overload("LaunchUriWithOptionsAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri, LauncherOptions options);function launchUriAsync(uri, options)Public Shared Function LaunchUriAsync (uri As Uri, options As LauncherOptions) As IAsyncOperation(Of Boolean)Parámetros
- options
- LauncherOptions
Las opciones de inicio de la aplicación.
Devoluciones
Devuelve true si se inició la aplicación predeterminada para el esquema URI; False en caso contrario.
- Atributos
Ejemplos
En este ejemplo se usa [LaunchUriAsync(Uri, LauncherOptions) para iniciar un URI con una advertencia. La propiedad TreatAsUntrusted indica que el sistema debe mostrar una advertencia.
// The URI to launch
string uriToLaunch = @"http://www.bing.com";
var uri = new Uri(uriToLaunch);
async void DefaultLaunch()
{
// Set the option to show a warning
var options = new Windows.System.LauncherOptions();
options.TreatAsUntrusted = true;
// Launch the URI with a warning prompt
var success = await Windows.System.Launcher.LaunchUriAsync(uri, options);
if (success)
{
// URI launched
}
else
{
// URI launch failed
}
}
// The URI to launch.
Windows::Foundation::Uri m_uri{ L"http://www.bing.com" };
Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
// Set the option to show a warning
Windows::System::LauncherOptions launcherOptions;
launcherOptions.TreatAsUntrusted(true);
// Launch the URI.
if (co_await Windows::System::Launcher::LaunchUriAsync(m_uri, launcherOptions))
{
// URI launched.
}
else
{
// URI launch failed.
}
}
// The URI to launch
auto uri = ref new Windows::Foundation::Uri("http://www.bing.com");
void MainPage::DefaultLaunch()
{
// Set the option to show a warning
auto launchOptions = ref new Windows::System::LauncherOptions();
launchOptions->TreatAsUntrusted = true;
// Launch the URI with a warning prompt
concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri, launchOptions));
launchUriOperation.then([](bool success)
{
if (success)
{
// URI launched
}
else
{
// URI launch failed
}
});
}
' The URI to launch
Dim uri As New Uri("http://www.bing.com")
async Sub DefaultLaunch()
' Set the option to show a warning
Dim options = Windows.System.LauncherOptions()
options.TreatAsUntrusted = True
' Launch the URI with a warning prompt
Dim success = await Windows.System.Launcher.LaunchUriAsync(uri, options)
If success Then
' URI launched
Else
' URI launch failed
End If
End Sub
Comentarios
A menos que llame a esta API desde una aplicación de escritorio de Windows, se debe llamar a esta API desde un subproceso de ASTA (también conocido como subproceso de interfaz de usuario).
También se puede llamar a esta API desde una aplicación de escritorio de Windows.
Esta API inicia la aplicación predeterminada para el esquema, ya sea una aplicación de Plataforma universal de Windows (UWP) o una aplicación de escritorio de Windows.
La aplicación que realiza la llamada debe ser visible para el usuario cuando se invoca esta API.
A menos que llame a esta API desde una aplicación de escritorio de Windows, se debe llamar a esta API desde un subproceso de ASTA (también conocido como subproceso de interfaz de usuario).
Debe especificar la funcionalidad privateNetworkClientServer en el manifiesto para iniciar URI de intranet, por ejemplo, un URI de file:/// que apunte a una ubicación de red.
No puede usar este método para iniciar un URI en la zona local. Por ejemplo, las aplicaciones no pueden usar el protocolo file:/// para acceder a los archivos del equipo local. En su lugar, debe usar las API de Storage para acceder a los archivos.
El tipo de contenido se usa para calcular una extensión de archivo, desde la extensión se elige la aplicación predeterminada. Por ejemplo, un valor de tipo de contenido de ""application/vnd.ms-word.document.12"" se asigna a ".docx" y, a continuación, se inicia la aplicación predeterminada para ".docx". Por ejemplo:
// this specifies the file type, which is used to bind to Word.
launcherOptions.ContentType = "application/vnd.ms-word.document.12";
// and then this launches the file using the application
Launcher.LaunchUriAsync("http://www.cloud.com/file.docx", options);
Cuando se produce un error en el inicio por cualquiera de los motivos anteriores, la API se realizará correctamente y devolverá FALSE desde su operación asincrónica.
Para permitir que el usuario elija una aplicación en lugar de iniciar la aplicación predeterminada, establezca la propiedad LauncherOptions.DisplayApplicationPicker .
Para mostrar una advertencia de que el URI no es seguro, establezca la propiedad LauncherOptions.TreatAsUntrusted .
El URI se pasa a la aplicación asociada. Si la aplicación asociada es una aplicación de escritorio, el URI se pasa mediante mecanismos de ejecución de shell.
Consulte también
- LaunchUriAsync(Uri)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Ejemplo de inicio por asociación
- Directrices sobre tipos de archivo y URI
- Iniciar la aplicación predeterminada para un URI
Se aplica a
LaunchUriAsync(Uri)
Inicia la aplicación predeterminada asociada al nombre del esquema de URI para el URI especificado.
public:
static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri);/// [Windows.Foundation.Metadata.Overload("LaunchUriAsync")]
static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri);[Windows.Foundation.Metadata.Overload("LaunchUriAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri);function launchUriAsync(uri)Public Shared Function LaunchUriAsync (uri As Uri) As IAsyncOperation(Of Boolean)Parámetros
Devoluciones
Devuelve true si se inició la aplicación predeterminada para el esquema URI; False en caso contrario.
- Atributos
Ejemplos
En este ejemplo se usa LaunchUriAsync(Uri) para iniciar un URI.
// The URI to launch
string uriToLaunch = @"http://www.bing.com";
// Create a Uri object from a URI string
var uri = new Uri(uriToLaunch);
// Launch the URI
async void DefaultLaunch()
{
// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uri);
if (success)
{
// URI launched
}
else
{
// URI launch failed
}
}
// The URI to launch.
Windows::Foundation::Uri m_uri{ L"http://www.bing.com" };
...
Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
// Launch the URI.
if (co_await Windows::System::Launcher::LaunchUriAsync(m_uri))
{
// URI launched.
}
else
{
// URI launch failed.
}
}
// The URI to launch
auto uri = ref new Windows::Foundation::Uri("http://www.bing.com");
void MainPage::DefaultLaunch()
{
// Launch the URI
concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri));
launchUriOperation.then([](bool success)
{
if (success)
{
// URI launched
}
else
{
// URI launch failed
}
});
}
' The URI to launch
Dim uri As New Uri("http://www.bing.com")
async Sub DefaultLaunch()
' Launch the URI
Dim success = await Windows.System.Launcher.LaunchUriAsync(uri)
If success Then
' URI launched
Else
' URI launch failed
End If
End Sub
Comentarios
A menos que llame a esta API desde una aplicación de escritorio de Windows, se debe llamar a esta API desde un subproceso de ASTA (también conocido como subproceso de interfaz de usuario).
También se puede llamar a esta API desde una aplicación de escritorio de Windows.
Esta API inicia la aplicación predeterminada para el esquema, ya sea una aplicación de Plataforma universal de Windows (UWP) o una aplicación de escritorio de Windows.
La aplicación que realiza la llamada debe ser visible para el usuario cuando se invoca la API.
Debe especificar la funcionalidad privateNetworkClientServer en el manifiesto para iniciar URI de intranet, por ejemplo, un URI de file:/// que apunte a una ubicación de red.
No puede usar este método para iniciar un URI en la zona local. Por ejemplo, las aplicaciones no pueden usar el protocolo file:/// para acceder a los archivos del equipo local. En su lugar, debe usar las API de Storage para acceder a los archivos.
Cuando se produce un error en el inicio por cualquiera de los motivos anteriores, la API se realizará correctamente y devolverá FALSE desde su operación asincrónica.
Para permitir que el usuario elija una aplicación en lugar de iniciar la aplicación predeterminada, establezca la propiedad LauncherOptions.DisplayApplicationPicker .
Para mostrar una advertencia de que el URI no es seguro, establezca la propiedad LauncherOptions.TreatAsUntrusted .
El URI se pasa a la aplicación asociada. Si la aplicación asociada es una aplicación de escritorio, el URI se pasa mediante mecanismos de ejecución de shell.
Consulte también
- LaunchUriAsync(Uri, LauncherOptions)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Ejemplo de inicio por asociación
- Directrices sobre tipos de archivo y URI
- Iniciar la aplicación predeterminada para un URI
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de