Launcher.LaunchUriAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 da 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
- options
- LauncherOptions
Opzioni di avvio per l'app.
- inputData
- ValueSet
Dati di input per l'app.
Importante
La quantità di dati che possono essere trasferiti 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ò essere chiamata anche da un'applicazione desktop di Windows.
Questa API avvia l'app predefinita per lo schema, indipendentemente dal fatto che si tratti di un'app piattaforma UWP (Universal Windows Platform) (UWP) 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 da 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
- 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ò essere chiamata anche da un'applicazione desktop di Windows.
Questa API avvia l'app predefinita per lo schema, indipendentemente dal fatto che si tratti di un'app piattaforma UWP (Universal Windows Platform) (UWP) 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 gli 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". Ad 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 non riesce per uno dei motivi precedenti, l'API avrà esito positivo e restituirà FALSE dall'operazione asincrona.
Per consentire all'utente di scegliere un'app anziché 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 i meccanismi di esecuzione della shell.
Vedi anche
- LaunchUriAsync(Uri)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Esempio di avvio di associazione
- Linee guida per tipi di file e URI
- Avviare l'app predefinita per un URI
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
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ò essere chiamata anche da un'applicazione desktop di Windows.
Questa API avvia l'app predefinita per lo schema, indipendentemente dal fatto che si tratti di un'app piattaforma UWP (Universal Windows Platform) (UWP) 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 gli 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 non riesce per uno dei motivi precedenti, l'API avrà esito positivo e restituirà FALSE dall'operazione asincrona.
Per consentire all'utente di scegliere un'app anziché 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 i meccanismi di esecuzione della shell.
Vedi anche
- LaunchUriAsync(Uri, LauncherOptions)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Esempio di avvio di associazione
- Linee guida per tipi di file e URI
- Avviare l'app predefinita per un URI
Si applica a
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per