Launcher.LaunchUriAsync Metodo

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

Restituisce

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

Attributi

OverloadAttribute

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

• 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)

Parametri

Restituisce

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

Attributi

OverloadAttribute

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

• LaunchUriAsync(Uri)
• LaunchUriAsync(Uri, LauncherOptions, ValueSet)
• Associazione che avvia di esempio
• Linee guida per i tipi di file e gli URI
• Avviare l'app predefinita per un 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)

Parametri

Restituisce

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

Attributi

OverloadAttribute

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

• LaunchUriAsync(Uri, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions, ValueSet)
• Associazione che avvia di esempio
• Linee guida per i tipi di file e gli URI
• Avviare l'app predefinita per un URI