Launcher.LaunchUriAsync Método

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

Retornos

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

Atributos

OverloadAttribute

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

• LaunchUriAsync(Uri)
• LaunchUriAsync(Uri, LauncherOptions)

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

Retornos

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

Atributos

OverloadAttribute

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

• LaunchUriAsync(Uri)
• LaunchUriAsync(Uri, LauncherOptions, ValueSet)
• de exemplo de inicialização da Associação
• Diretrizes de para tipos de arquivo e URIs
• iniciar o aplicativo padrão para um URI

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

Retornos

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

Atributos

OverloadAttribute

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

• LaunchUriAsync(Uri, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions, ValueSet)
• de exemplo de inicialização da Associação
• Diretrizes de para tipos de arquivo e URIs
• iniciar o aplicativo padrão para um URI