SharedStorageAccessManager クラス

定義

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 の要件

例

次の例では、ソース アプリがマッピング アプリを起動し、ターゲット アプリによって表示される駆動方向を含む .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 クラスと共有トークンの使用には、次の要件と制限が適用されます。

• 共有トークンは 1 回だけ引き換えることができます。 その後、トークンは無効になります。
• 共有トークンは 14 日後に期限切れになり、無効になります。
• ソース アプリは、1000 を超える共有トークンを取得できません。 ただし、トークンが引き換え、削除、または期限切れになると、ソース アプリのクォータにカウントされなくなります。

このクラスでは、ネットワーク ファイルはサポートされていません。

メソッド

適用対象