Launcher.LaunchUriAsync Método

Referencia

Definición

Espacio de nombres:: Windows.System

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 del 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 con el nombre del esquema de URI o el especificado por el ContentType para el URI especificado, utilizando las opciones especificadas.
LaunchUriAsync(Uri)	Inicia la aplicación predeterminada asociada al nombre del esquema URI para el URI especificado.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Editar

Inicia la aplicación predeterminada asociada al nombre del 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

uri: Uri Uri

Identificador URI.

options: LauncherOptions

Las opciones de inicio de la aplicación.

Importante

La propiedad TargetApplicationPackageFamilyName del parámetro options, aunque a veces es opcional, es necesaria para esta sobrecarga del método launchUriAsync de .

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

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Devuelve true si se inició la aplicación predeterminada para el esquema de URI; false en caso contrario.

Atributos: OverloadAttribute

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 para la Plataforma universal de Windows (UWP) o una aplicación de escritorio de Windows.

Consulte también

Se aplica a

LaunchUriAsync(Uri, LauncherOptions)

Editar

Inicia la aplicación predeterminada asociada con el nombre del esquema de URI o el especificado por el 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

uri: Uri Uri

Identificador URI.

options: LauncherOptions

Las opciones de inicio de la aplicación.

Devoluciones

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Devuelve true si se inició la aplicación predeterminada para el esquema de URI; false en caso contrario.

Atributos: OverloadAttribute

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 para la 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 los URI de intranet, por ejemplo, un URI de file:/// que apunta 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 almacenamiento de 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)
de inicio de asociación de
Directrices para tipos de archivo y URI
Iniciar la aplicación predeterminada para un de URI

Se aplica a

LaunchUriAsync(Uri)

Editar

Inicia la aplicación predeterminada asociada al nombre del esquema 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

uri: Uri Uri

Identificador URI.

Devoluciones

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Devuelve true si se inició la aplicación predeterminada para el esquema de URI; false en caso contrario.

Atributos: OverloadAttribute

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 para la Plataforma universal de Windows (UWP) o una aplicación de escritorio de Windows.

La aplicación que realiza la llamada debe estar visible para el usuario cuando se invoca la API.

Debe especificar la funcionalidad privateNetworkClientServer en el manifiesto para iniciar los URI de intranet, por ejemplo, un URI de file:/// que apunta a una ubicación de red.

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)
de inicio de asociación de
Directrices para tipos de archivo y URI
Iniciar la aplicación predeterminada para un de URI

Se aplica a

Compartir a través de

Launcher.LaunchUriAsync Método

Definición

Sobrecargas

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Parámetros

Devoluciones

Comentarios

Consulte también

Se aplica a

LaunchUriAsync(Uri, LauncherOptions)

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

LaunchUriAsync(Uri)

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Comentarios

Recursos adicionales