SharedStorageAccessManager Kelas
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.
Memungkinkan aplikasi berbagi file dengan aplikasi lain dengan meneruskan token melalui aktivasi Uri, layanan aplikasi, REST API, dll. Aplikasi target menukarkan token untuk mendapatkan file yang dibagikan oleh aplikasi sumber.
public ref class SharedStorageAccessManager abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class SharedStorageAccessManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class SharedStorageAccessManager
Public Class SharedStorageAccessManager
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Dalam contoh berikut, aplikasi sumber meluncurkan aplikasi pemetaan dan menyediakan file .gpx yang berisi petunjuk arah mengemudi yang akan ditampilkan oleh aplikasi target.
Pertama, aplikasi sumber mendapatkan token untuk file .gpx dan menggunakan aktivasi protokol untuk meluncurkan aplikasi target.
public async void ShareMostRecentDirections()
{
// Get the most recently opened .gpx file
// from the recently used file list.
StorageItemMostRecentlyUsedList mostRecent =
StorageApplicationPermissions.MostRecentlyUsedList;
String mruToken = mostRecent.Entries.FirstOrDefault().Token;
StorageFile file = await mostRecent.GetFileAsync(mruToken);
// Get the token to share access to the updated .gpx file.
String sharingToken = SharedStorageAccessManager.AddFile(file);
//Launch the driving application .
Uri driveTo = new Uri("nokia-drive-to:?Gpxfile=" + sharingToken);
var launch = await Launcher.LaunchURIAsync(driveTo);
}
Selanjutnya, aplikasi target mendapatkan file .gpx dengan menyediakan token yang diterima dari aplikasi sumber.
protected override async void OnActivated(IActivatedEventArgs args)
{
var protocolArgs = args as ProtocolActivatedEventArgs;
// Get the token from the URI.
var queryStrings = new WwwFormUrlDecoder(protocolArgs.Uri.Query);
string gpxFileToken = queryStrings.GetFirstValueByName("GpxFile");
// Get the .gpx file and call a custom method
// to display driving directions.
if (!string.IsNullOrEmpty(gpxFileToken))
{
PlotGpxFile(await
SharedStorageAccessManager.RedeemTokenForFileAsync(gpxFileToken));
}
}
Keterangan
Berikut adalah urutan langkah-langkah yang memungkinkan aplikasi berbagi file dengan aplikasi lain dengan meneruskan token sebagai bagian dari aktivasi Uri, misalnya.
- Aplikasi sumber memanggil metode AddFile untuk mendapatkan token berbagi yang diteruskannya ke aplikasi target, yang diluncurkannya dengan Uri.
- Aplikasi target memanggil metode RedeemTokenForFileAsync untuk mendapatkan file bersama.
- Secara opsional, aplikasi sumber dapat memanggil metode RemoveFile untuk mencabut token yang diperoleh sebelumnya dengan memanggil metode AddFile . Untuk informasi selengkapnya tentang aktivasi Uri, lihat Meluncurkan aplikasi default untuk URI.
Penggunaan kelas SharedStorageAccessManager dan token berbagi tunduk pada persyaratan dan batasan berikut.
- Token berbagi hanya dapat ditukarkan satu kali. Setelah itu, token tidak lagi valid.
- Token berbagi kedaluwarsa setelah 14 hari dan tidak lagi valid.
- Aplikasi sumber tidak bisa mendapatkan lebih dari seribu token berbagi. Namun, setelah token ditukarkan, dihapus, atau kedaluwarsa, token tidak lagi dihitung terhadap kuota aplikasi sumber.
File jaringan tidak didukung dengan kelas ini.
Metode
AddFile(IStorageFile) |
Mendapatkan token berbagi yang memungkinkan aplikasi berbagi file yang ditentukan dengan aplikasi lain. |
RedeemTokenForFileAsync(String) |
Mendapatkan file yang dibagikan oleh aplikasi lain dengan menyediakan token berbagi yang diterima dari aplikasi sumber. |
RemoveFile(String) |
Mencabut token berbagi yang ada. |