Compartilhar via


Launcher.LaunchUriAsync Método

Definição

Sobrecargas

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Inicia o aplicativo padrão associado ao nome do esquema de URI para o URI especificado, usando as opções especificadas e os dados de entrada.

LaunchUriAsync(Uri, LauncherOptions)

Inicia o aplicativo padrão associado ao nome do esquema de URI ou aquele especificado pelo ContentType para o URI especificado, usando as opções especificadas.

LaunchUriAsync(Uri)

Inicia o aplicativo padrão associado ao nome do esquema de URI para o URI especificado.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Inicia o aplicativo padrão associado ao nome do esquema de URI para o URI especificado, usando as opções especificadas e os dados de entrada.

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

O URI.

options
LauncherOptions

As opções de inicialização do aplicativo.

Importante

A propriedade TargetApplicationPackageFamilyName das opções parâmetro, embora às vezes opcional, é necessária para essa sobrecarga do método LaunchUriAsync .

inputData
ValueSet

Os dados de entrada do aplicativo.

Importante

A quantidade de dados que podem ser transferidos não deve exceder 100 KB.

Retornos

Retorna verdadeiro se o aplicativo padrão para o esquema de URI foi iniciado; falso caso contrário.

Atributos

Comentários

A menos que você esteja chamando essa API de um aplicativo da área de trabalho do Windows, essa API deve ser chamada de dentro de um thread ASTA (também conhecido como thread de interface do usuário).

Essa API também pode ser chamada de um aplicativo da área de trabalho do Windows.

Essa API inicia o aplicativo padrão para o esquema, seja um aplicativo da Plataforma Universal do Windows (UWP) ou um aplicativo da área de trabalho do Windows.

Confira também

Aplica-se a

LaunchUriAsync(Uri, LauncherOptions)

Inicia o aplicativo padrão associado ao nome do esquema de URI ou aquele especificado pelo ContentType para o URI especificado, usando as opções 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

O URI.

options
LauncherOptions

As opções de inicialização do aplicativo.

Retornos

Retorna verdadeiro se o aplicativo padrão para o esquema de URI foi iniciado; falso caso contrário.

Atributos

Exemplos

Este exemplo usa [LaunchUriAsync(Uri, LauncherOptions) para iniciar um URI com um aviso. A propriedade TreatAsUntrusted indica que o sistema deve exibir um aviso.

// 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

Comentários

A menos que você esteja chamando essa API de um aplicativo da área de trabalho do Windows, essa API deve ser chamada de dentro de um thread ASTA (também conhecido como thread de interface do usuário).

Essa API também pode ser chamada de um aplicativo da área de trabalho do Windows.

Essa API inicia o aplicativo padrão para o esquema, seja um aplicativo da Plataforma Universal do Windows (UWP) ou um aplicativo da área de trabalho do Windows.

O aplicativo de chamada deve estar visível para o usuário quando essa API é invocada.

A menos que você esteja chamando essa API de um aplicativo da área de trabalho do Windows, essa API deve ser chamada de dentro de um thread ASTA (também conhecido como thread de interface do usuário).

Você deve especificar a funcionalidade privateNetworkClientServer no manifesto para iniciar URIs de intranet, por exemplo, um URI file:/// apontando para um local de rede.

Você não pode usar esse método para iniciar um URI na zona local. Por exemplo, os aplicativos não podem usar o protocolo file:/// para acessar arquivos no computador local. Em vez disso, você deve usar as APIs de Armazenamento para acessar arquivos.

O tipo de conteúdo é usado para calcular uma extensão de arquivo, na extensão em que o aplicativo padrão é escolhido. Por exemplo, um valor de tipo de conteúdo ""application/vnd.ms-word.document.12"" é mapeado para ".docx" e, em seguida, o aplicativo padrão para ".docx" é iniciado. Por exemplo:

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

Quando a inicialização falhar por qualquer um dos motivos acima, a API terá êxito e retornará FALSE de sua operação assíncrona.

Para permitir que o usuário escolha um aplicativo em vez de iniciar o aplicativo padrão, defina a propriedade LauncherOptions.DisplayApplicationPicker.

Para exibir um aviso de que o URI é potencialmente não seguro, defina a propriedade LauncherOptions.TreatAsUntrusted.

O URI é passado para o aplicativo associado. Se o aplicativo associado for um aplicativo da área de trabalho, o URI será passado usando mecanismos de execução de shell.

Confira também

Aplica-se a

LaunchUriAsync(Uri)

Inicia o aplicativo padrão associado ao nome do esquema de URI para o 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

O URI.

Retornos

Retorna verdadeiro se o aplicativo padrão para o esquema de URI foi iniciado; falso caso contrário.

Atributos

Exemplos

Este exemplo usa LaunchUriAsync(Uri) para iniciar um 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

Comentários

A menos que você esteja chamando essa API de um aplicativo da área de trabalho do Windows, essa API deve ser chamada de dentro de um thread ASTA (também conhecido como thread de interface do usuário).

Essa API também pode ser chamada de um aplicativo da área de trabalho do Windows.

Essa API inicia o aplicativo padrão para o esquema, seja um aplicativo da Plataforma Universal do Windows (UWP) ou um aplicativo da área de trabalho do Windows.

O aplicativo de chamada deve estar visível para o usuário quando a API é invocada.

Você deve especificar a funcionalidade privateNetworkClientServer no manifesto para iniciar URIs de intranet, por exemplo, um URI file:/// apontando para um local de rede.

Você não pode usar esse método para iniciar um URI na zona local. Por exemplo, os aplicativos não podem usar o protocolo file:/// para acessar arquivos no computador local. Em vez disso, você deve usar as APIs de Armazenamento para acessar arquivos.

Quando a inicialização falhar por qualquer um dos motivos acima, a API terá êxito e retornará FALSE de sua operação assíncrona.

Para permitir que o usuário escolha um aplicativo em vez de iniciar o aplicativo padrão, defina a propriedade LauncherOptions.DisplayApplicationPicker.

Para exibir um aviso de que o URI é potencialmente não seguro, defina a propriedade LauncherOptions.TreatAsUntrusted.

O URI é passado para o aplicativo associado. Se o aplicativo associado for um aplicativo da área de trabalho, o URI será passado usando mecanismos de execução de shell.

Confira também

Aplica-se a