Launcher.LaunchUriAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
LaunchUriAsync(Uri, LauncherOptions, ValueSet) |
Memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan, menggunakan opsi dan data input yang ditentukan. |
LaunchUriAsync(Uri, LauncherOptions) |
Memulai aplikasi default yang terkait dengan nama skema URI atau yang ditentukan oleh ContentType untuk URI yang ditentukan, menggunakan opsi yang ditentukan. |
LaunchUriAsync(Uri) |
Memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan. |
LaunchUriAsync(Uri, LauncherOptions, ValueSet)
Memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan, menggunakan opsi dan data input yang ditentukan.
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)
Parameter
- options
- LauncherOptions
Opsi peluncuran untuk aplikasi.
Penting
Properti TargetApplicationPackageFamilyName dari opsi parameter, sementara terkadang opsional, diperlukan untuk kelebihan beban metode LaunchUriAsync ini.
- inputData
- ValueSet
Data input untuk aplikasi.
Penting
Jumlah data yang dapat ditransfer tidak boleh melebihi 100 KB.
Mengembalikan
Mengembalikan true jika aplikasi default untuk skema URI diluncurkan; false sebaliknya.
- Atribut
Keterangan
Kecuali Anda memanggil API ini dari aplikasi desktop Windows, API ini harus dipanggil dari dalam utas ASTA (juga dikenal sebagai utas UI).
API ini juga dapat dipanggil dari aplikasi desktop Windows.
API ini meluncurkan aplikasi default untuk skema apakah itu aplikasi Universal Windows Platform (UWP) atau aplikasi desktop Windows.
Lihat juga
Berlaku untuk
LaunchUriAsync(Uri, LauncherOptions)
Memulai aplikasi default yang terkait dengan nama skema URI atau yang ditentukan oleh ContentType untuk URI yang ditentukan, menggunakan opsi yang ditentukan.
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)
Parameter
- options
- LauncherOptions
Opsi peluncuran untuk aplikasi.
Mengembalikan
Mengembalikan true jika aplikasi default untuk skema URI diluncurkan; false sebaliknya.
- Atribut
Contoh
Sampel ini menggunakan [LaunchUriAsync(Uri, LauncherOptions) untuk meluncurkan URI dengan peringatan. Properti TreatAsUntrusted menunjukkan bahwa sistem harus menampilkan peringatan.
// 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
Keterangan
Kecuali Anda memanggil API ini dari aplikasi desktop Windows, API ini harus dipanggil dari dalam utas ASTA (juga dikenal sebagai utas UI).
API ini juga dapat dipanggil dari aplikasi desktop Windows.
API ini meluncurkan aplikasi default untuk skema apakah itu aplikasi Universal Windows Platform (UWP) atau aplikasi desktop Windows.
Aplikasi panggilan harus terlihat oleh pengguna saat API ini dipanggil.
Kecuali Anda memanggil API ini dari aplikasi desktop Windows, API ini harus dipanggil dari dalam utas ASTA (juga dikenal sebagai utas UI).
Anda harus menentukan kemampuan privateNetworkClientServer
Anda tidak dapat menggunakan metode ini untuk meluncurkan URI di zona lokal. Misalnya, aplikasi tidak dapat menggunakan protokol file:/// untuk mengakses file di komputer lokal. Sebagai gantinya, Anda harus menggunakan API Penyimpanan
Jenis konten digunakan untuk menghitung ekstensi file, dari ekstensi, aplikasi default dipilih. Misalnya nilai jenis konten ""application/vnd.ms-word.document.12"" dipetakan ke ".docx" dan kemudian aplikasi default untuk ".docx" diluncurkan. Misalnya:
// 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);
Ketika peluncuran gagal karena salah satu alasan di atas, API akan berhasil dan mengembalikan FALSE dari operasi asinkronnya.
Untuk memungkinkan pengguna memilih aplikasi alih-alih meluncurkan aplikasi default, atur properti LauncherOptions.DisplayApplicationPicker.
Untuk menampilkan peringatan bahwa URI berpotensi tidak aman, atur properti LauncherOptions.TreatAsUntrusted.
URI diteruskan ke aplikasi terkait. Jika aplikasi terkait adalah aplikasi desktop, URI diteruskan menggunakan mekanisme eksekusi shell.
Lihat juga
- LaunchUriAsync(Uri)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- sampel peluncuran Asosiasi
- Panduan untuk jenis file dan URI
- Meluncurkan aplikasi default untuk URI
Berlaku untuk
LaunchUriAsync(Uri)
Memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan.
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)
Parameter
Mengembalikan
Mengembalikan true jika aplikasi default untuk skema URI diluncurkan; false sebaliknya.
- Atribut
Contoh
Contoh ini menggunakan LaunchUriAsync(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
Keterangan
Kecuali Anda memanggil API ini dari aplikasi desktop Windows, API ini harus dipanggil dari dalam utas ASTA (juga dikenal sebagai utas UI).
API ini juga dapat dipanggil dari aplikasi desktop Windows.
API ini meluncurkan aplikasi default untuk skema apakah itu aplikasi Universal Windows Platform (UWP) atau aplikasi desktop Windows.
Aplikasi panggilan harus terlihat oleh pengguna saat API dipanggil.
Anda harus menentukan kemampuan privateNetworkClientServer
Anda tidak dapat menggunakan metode ini untuk meluncurkan URI di zona lokal. Misalnya, aplikasi tidak dapat menggunakan protokol file:/// untuk mengakses file di komputer lokal. Sebagai gantinya, Anda harus menggunakan API Penyimpanan
Ketika peluncuran gagal karena salah satu alasan di atas, API akan berhasil dan mengembalikan FALSE dari operasi asinkronnya.
Untuk memungkinkan pengguna memilih aplikasi alih-alih meluncurkan aplikasi default, atur properti LauncherOptions.DisplayApplicationPicker.
Untuk menampilkan peringatan bahwa URI berpotensi tidak aman, atur properti LauncherOptions.TreatAsUntrusted.
URI diteruskan ke aplikasi terkait. Jika aplikasi terkait adalah aplikasi desktop, URI diteruskan menggunakan mekanisme eksekusi shell.
Lihat juga
- LaunchUriAsync(Uri, LauncherOptions)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- sampel peluncuran Asosiasi
- Panduan untuk jenis file dan URI
- Meluncurkan aplikasi default untuk URI