SharedStorageAccessManager 類別

定義

命名空間:

Windows.ApplicationModel.DataTransfer

透過 Uri 啟用、應用程式服務、REST API 等方式傳遞權杖，讓應用程式與另一個應用程式共用檔案。目標應用程式會兌換權杖，以取得來源應用程式共用的檔案。

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

繼承

Object Platform::Object IInspectable SharedStorageAccessManager

屬性

ContractVersionAttribute

Windows 需求

規格需求	Description
裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

在下列範例中，來源應用程式會啟動對應應用程式，並提供 .gpx 檔案，其中包含目標應用程式要顯示的駕駛方向。

首先，來源應用程式會取得 .gpx 檔案的權杖，並使用通訊協定啟用來啟動目標應用程式。

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);
}

接下來，目標應用程式會提供從來源應用程式收到的權杖，以取得 .gpx 檔案。

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));
    }
}

備註

以下是一連串的步驟，可讓應用程式透過傳遞權杖作為 Uri 啟用的一部分，來與另一個應用程式共用檔案。

• 來源應用程式會呼叫 AddFile 方法，以取得其傳遞至目標應用程式的共用權杖，其會以 Uri 啟動。
• 目標應用程式會呼叫 RedeemTokenForFileAsync 方法來取得共用檔案。
• 或者，來源應用程式可以呼叫 RemoveFile 方法，藉由呼叫 AddFile 方法撤銷先前取得的權杖。 如需 URI 啟用的詳細資訊，請參閱 啟動 URI 的預設應用程式。

使用 SharedStorageAccessManager 類別和共用權杖受限於下列需求和限制。

• 共用權杖只能兌換一次。 之後，權杖就不再有效。
• 共用權杖會在 14 天后到期，且不再有效。
• 來源應用程式無法取得一千個以上的共用權杖。 不過，在兌換、移除或到期權杖之後，它不再計入來源應用程式的配額。

此類別不支援網路檔案。

方法

名稱	Description
AddFile(IStorageFile)	取得共用權杖，可讓應用程式與其他應用程式共用指定的檔案。
RedeemTokenForFileAsync(String)	藉由提供從來源應用程式收到的共用權杖，取得另一個應用程式所共用的檔案。
RemoveFile(String)	撤銷現有的共用權杖。