SharedStorageAccessManager Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.DataTransfer

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

Object Platform::Object IInspectable SharedStorageAccessManager

Atribut

ContractVersionAttribute

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.