Launcher.LaunchUriAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- options
- LauncherOptions
As opções de inicialização do aplicativo.
- 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 true se o aplicativo padrão para o esquema de URI foi iniciado; false 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 do 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 de Plataforma Universal do Windows (UWP) ou 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
- options
- LauncherOptions
As opções de inicialização do aplicativo.
Retornos
Retorna true se o aplicativo padrão para o esquema de URI foi iniciado; false 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 do 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 de Plataforma Universal do Windows (UWP) ou 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 do 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 inseguro, 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 do shell.
Confira também
- LaunchUriAsync(Uri)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Amostra de inicialização de associação
- Diretrizes para tipos de arquivos e URIs
- Iniciar o app padrão para um URI
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
Retornos
Retorna true se o aplicativo padrão para o esquema de URI foi iniciado; false 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 do 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 de Plataforma Universal do Windows (UWP) ou 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 inseguro, 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 do shell.
Confira também
- LaunchUriAsync(Uri, LauncherOptions)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Amostra de inicialização de associação
- Diretrizes para tipos de arquivos e URIs
- Iniciar o app padrão para um URI
Aplica-se a
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários