StorageApplicationPermissions Klasse

Referenz

Definition

Namespace:: Windows.Storage.AccessCache

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt statische Eigenschaften bereit, mit deren Hilfe Sie die zuletzt verwendete Liste (MRU) Ihrer App ( StorageApplicationPermissions.MostRecentlyUsedList) und die Liste für den zukünftigen Zugriff (verwenden Sie StorageApplicationPermissions.FutureAccessList) abrufen können.

public ref class StorageApplicationPermissions abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageApplicationPermissions final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class StorageApplicationPermissions

Public Class StorageApplicationPermissions

Vererbung: Object Platform::Object IInspectable StorageApplicationPermissions

Attribute: ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird veranschaulicht, wie Sie ein Element zu FutureAccessList und MostRecentlyUsedList der App hinzufügen.

StorageFile file = await savePicker.PickSaveFileAsync();
if (file != null)
{
    // Add to MRU with metadata (For example, a string that represents the date)
    string mruToken = Windows.Storage.AccessCache.StorageApplicationPermissions.MostRecentlyUsedList.Add(file, "20120716");

    // Add to FA without metadata
    string faToken = Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);  
}
else
{
    // The file picker was dismissed with no file selected to save
}

#include <sstream>
#include <winrt/Windows.Storage.h>
#include <winrt/Windows.Storage.AccessCache.h>
#include <winrt/Windows.Storage.Pickers.h>
using namespace winrt;
using namespace Windows::Storage::Pickers;
using namespace Windows::Storage;
...
winrt::fire_and_forget AddToLists()
{
    FileSavePicker savePicker;
    auto plainTextExtensions{ winrt::single_threaded_vector<winrt::hstring>() };
    plainTextExtensions.Append(L".txt");
    savePicker.FileTypeChoices().Insert(L"Plain Text", plainTextExtensions);
    savePicker.SuggestedFileName(L"New Document");

    StorageFile file{ co_await savePicker.PickSaveFileAsync() };
    if (file)
    {
        // Add to MRU with metadata (For example, a string that represents the date)
        winrt::hstring mruToken { Windows::Storage::AccessCache::StorageApplicationPermissions::MostRecentlyUsedList().Add(file, L"20120716") };

        // Add to FA without metadata
        winrt::hstring faToken { Windows::Storage::AccessCache::StorageApplicationPermissions::FutureAccessList().Add(file) };
    }
    else
    {
        // The file picker was dismissed with no file selected to save
    }
}

Es wird empfohlen, die von StorageApplicationPermissions.MostRecentlyUsedList.Add und StorageApplicationPermissions.FutureAccessList.Add zurückgegebenen Token zu speichern, damit Sie damit den entsprechenden Listeneintrag für das hinzugefügte Element abrufen können. Im Beispiel speichern wir die Token in mruToken bzw faToken ., aber wir machen nichts anderes mit ihnen.

Darüber hinaus enthält die savePicker Variable im Beispiel ein FileSavePicker-Objekt , das vom Beispiel erstellt wurde. Weitere Informationen zum Speichern von Dateien mit der Dateiauswahl finden Sie unter Speichern einer Datei mit einer Auswahl. Informationen zum Zugreifen auf Dateien finden Sie unter Öffnen von Dateien und Ordnern mit einer Auswahl.

Hinweise

Greifen Sie statisch auf die Methoden und Eigenschaften dieser Klasse zu.

Weitere Codebeispiele finden Sie im Beispiel für die Dateiauswahl und im Dateizugriffsbeispiel.

Informationen zur Verwendung von FutureAccessList und MostRecentlyUsedList finden Sie unter Nachverfolgen zuletzt verwendeter Dateien und Ordner.

Informationen dazu, auf welche Dateien und Speicherorte Ihre App zugreifen kann, finden Sie unter Dateizugriffsberechtigungen.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1903	18362	GetFutureAccessListForUser
1903	18362	GetMostRecentlyUsedListForUser

Eigenschaften

FutureAccessList	Ruft ein -Objekt ab, das eine Liste darstellt, die von einer App verwaltet wird, damit die App Dateien und/oder Speicherorte (z. B. Ordner) speichern und in Zukunft problemlos auf diese Elemente zugreifen kann.
MostRecentlyUsedList	Ruft ein -Objekt ab, das eine Liste darstellt, mit der eine App die Dateien und/oder Speicherorte (z. B. Ordner) nachverfolgen kann, auf die die App zuletzt zugegriffen hat.

Methoden

GetFutureAccessListForUser(User)	Ruft ein -Objekt ab, das eine Liste darstellt, die von einer App verwaltet wird, damit die App Dateien und/oder Speicherorte (z. B. Ordner) speichern und in Zukunft problemlos auf diese Elemente zugreifen kann. Diese Methode gibt ein Objekt zurück, das auf den angegebenen Benutzer festgelegt ist. Verwenden Sie diese Methode für Anwendungen mit mehreren Benutzern.
GetMostRecentlyUsedListForUser(User)	Ruft ein Objekt ab, mit dem eine App die Dateien und/oder Speicherorte (z. B. Ordner) nachverfolgen kann, auf die die App zuletzt zugegriffen hat. Diese Methode gibt ein Objekt zurück, das auf den angegebenen Benutzer festgelegt ist. Verwenden Sie diese Methode für Anwendungen mit mehreren Benutzern.

Gilt für:

Freigeben über