Launcher.LaunchUriAsync Metodo

Definizione

Overload

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Avvia l'app predefinita associata al nome dello schema URI per l'URI specificato, usando le opzioni e i dati di input specificati.

LaunchUriAsync(Uri, LauncherOptions)

Avvia l'app predefinita associata al nome dello schema URI o a quella specificata dal ContentType per l'URI specificato, usando le opzioni specificate.

LaunchUriAsync(Uri)

Avvia l'app predefinita associata al nome dello schema URI per l'URI specificato.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Avvia l'app predefinita associata al nome dello schema URI per l'URI specificato, usando le opzioni e i dati di input specificati.

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)

Parametri

uri
Uri Uri

The URI.

options
LauncherOptions

Opzioni di avvio per l'app.

Importante

La proprietà TargetApplicationPackageFamilyName del parametro opzioni, anche se talvolta facoltativa, è necessaria per questo overload del metodo LaunchUriAsync .

inputData
ValueSet

Dati di input per l'app.

Importante

La quantità di dati che è possibile trasferire non deve superare 100 KB.

Restituisce

Restituisce true se è stata avviata l'app predefinita per lo schema URI; false in caso contrario.

Attributi

Commenti

A meno che non chiami questa API da un'applicazione desktop di Windows, questa API deve essere chiamata dall'interno di un thread ASTA (noto anche come thread dell'interfaccia utente).

Questa API può anche essere chiamata da un'applicazione desktop di Windows.

Questa API avvia l'app predefinita per lo schema, indipendentemente dal fatto che si tratti di un'app UWP (Universal Windows Platform) o di un'applicazione desktop di Windows.

Vedi anche

Si applica a

LaunchUriAsync(Uri, LauncherOptions)

Avvia l'app predefinita associata al nome dello schema URI o a quella specificata dal ContentType per l'URI specificato, usando le opzioni specificate.

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)

Parametri

uri
Uri Uri

The URI.

options
LauncherOptions

Opzioni di avvio per l'app.

Restituisce

Restituisce true se è stata avviata l'app predefinita per lo schema URI; false in caso contrario.

Attributi

Esempio

Questo esempio usa [LaunchUriAsync(Uri, LauncherOptions) per avviare un URI con un avviso. La proprietà treatAsUntrusted indica che il sistema deve visualizzare un avviso.

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

Commenti

A meno che non chiami questa API da un'applicazione desktop di Windows, questa API deve essere chiamata dall'interno di un thread ASTA (noto anche come thread dell'interfaccia utente).

Questa API può anche essere chiamata da un'applicazione desktop di Windows.

Questa API avvia l'app predefinita per lo schema, indipendentemente dal fatto che si tratti di un'app UWP (Universal Windows Platform) o di un'applicazione desktop di Windows.

L'app chiamante deve essere visibile all'utente quando questa API viene richiamata.

A meno che non chiami questa API da un'applicazione desktop di Windows, questa API deve essere chiamata dall'interno di un thread ASTA (noto anche come thread dell'interfaccia utente).

È necessario specificare la funzionalità privateNetworkClientServer nel manifesto per avviare URI Intranet, ad esempio un URI file:/// che punta a un percorso di rete.

Non è possibile usare questo metodo per avviare un URI nella zona locale. Ad esempio, le app non possono usare il protocollo file:/// per accedere ai file nel computer locale. È invece necessario usare le API di archiviazione per accedere ai file.

Il tipo di contenuto viene usato per calcolare un'estensione di file, dall'estensione scelta l'app predefinita. Ad esempio, il valore del tipo di contenuto ""application/vnd.ms-word.document.12"" viene mappato a ".docx" e quindi viene avviata l'applicazione predefinita per ".docx". Per esempio:

// 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 l'avvio ha esito negativo per uno dei motivi precedenti, l'API avrà esito positivo e restituirà FALSE dall'operazione asincrona.

Per consentire all'utente di scegliere un'app invece di avviare l'app predefinita, impostare la proprietà LauncherOptions.DisplayApplicationPicker.

Per visualizzare un avviso che indica che l'URI è potenzialmente non sicuro, impostare la proprietà LauncherOptions.TreatAsUntrusted.

L'URI viene passato all'app associata. Se l'app associata è un'app desktop, l'URI viene passato usando meccanismi di esecuzione della shell.

Vedi anche

Si applica a

LaunchUriAsync(Uri)

Avvia l'app predefinita associata al nome dello schema URI per l'URI specificato.

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)

Parametri

uri
Uri Uri

The URI.

Restituisce

Restituisce true se è stata avviata l'app predefinita per lo schema URI; false in caso contrario.

Attributi

Esempio

Questo esempio usa launchUriAsync(Uri) per avviare 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

Commenti

A meno che non chiami questa API da un'applicazione desktop di Windows, questa API deve essere chiamata dall'interno di un thread ASTA (noto anche come thread dell'interfaccia utente).

Questa API può anche essere chiamata da un'applicazione desktop di Windows.

Questa API avvia l'app predefinita per lo schema, indipendentemente dal fatto che si tratti di un'app UWP (Universal Windows Platform) o di un'applicazione desktop di Windows.

L'app chiamante deve essere visibile all'utente quando viene richiamata l'API.

È necessario specificare la funzionalità privateNetworkClientServer nel manifesto per avviare URI Intranet, ad esempio un URI file:/// che punta a un percorso di rete.

Non è possibile usare questo metodo per avviare un URI nella zona locale. Ad esempio, le app non possono usare il protocollo file:/// per accedere ai file nel computer locale. È invece necessario usare le API di archiviazione per accedere ai file.

Quando l'avvio ha esito negativo per uno dei motivi precedenti, l'API avrà esito positivo e restituirà FALSE dall'operazione asincrona.

Per consentire all'utente di scegliere un'app invece di avviare l'app predefinita, impostare la proprietà LauncherOptions.DisplayApplicationPicker.

Per visualizzare un avviso che indica che l'URI è potenzialmente non sicuro, impostare la proprietà LauncherOptions.TreatAsUntrusted.

L'URI viene passato all'app associata. Se l'app associata è un'app desktop, l'URI viene passato usando meccanismi di esecuzione della shell.

Vedi anche

Si applica a