StorageItemAccessList Klasse

Definition

Namespace:

Windows.Storage.AccessCache

Stellt die Liste für den zukünftigen Zugriff Ihrer App dar (abgerufen aus der statischen StorageApplicationPermissions.FutureAccessList-Eigenschaft ). Durch die Auswahl von Dateien und Ordnern erteilt der Benutzer Ihrer App die Berechtigung zum Zugreifen auf Elemente, auf die andernfalls nicht zugegriffen werden kann. Wenn Sie diese Elemente zu Ihrer Liste für zukünftigen Zugriff hinzufügen, behalten Sie die Berechtigung, wenn Ihre App später erneut auf diese Elemente zugreifen möchte. Elemente werden in der Liste für zukünftige Zugriffe als StorageFile - und StorageFolder-Objekte gespeichert.

public ref class StorageItemAccessList sealed : IStorageItemAccessList

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemAccessList final : IStorageItemAccessList

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemAccessList : IStorageItemAccessList

Public NotInheritable Class StorageItemAccessList
Implements IStorageItemAccessList

Vererbung

Object Platform::Object IInspectable StorageItemAccessList

Attribute

ContractVersionAttribute

Implementiert

IStorageItemAccessList

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 zur Verwendung der Dateiauswahl finden Sie unter Öffnen von Dateien und Ordnern mit einer Auswahl und Speichern einer Datei mit einer Auswahl.

Hinweise

Verwenden Sie diese Liste für den zukünftigen Zugriff, um den Zugriff auf Dateien und Speicherorte beizubehalten, die möglicherweise nicht in den von den Funktionen in Ihrem App-Manifest angegebenen barrierefreien Speicherorten enthalten sind. Wenn Ihre App beispielsweise eine Dateiauswahl für den Zugriff auf eine Datei (oder einen Speicherort) verwendet, empfiehlt es sich, die StorageFile-Datei zu speichern, die von der Dateiauswahl in dieser Liste für den zukünftigen Zugriff zurückgegeben wird.

Diese Liste kann bis zu 1000 Elemente speichern und muss von der App verwaltet werden.

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.

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

Eigenschaften

Entries	Ruft ein -Objekt zum Abrufen von Speicherelementen aus der Zugriffsliste ab.
MaximumItemsAllowed	Ruft die maximale Anzahl von Speicherelementen ab, die die Zugriffsliste enthalten kann.

Methoden

Add(IStorageItem)	Fügt der Zugriffsliste ein neues Speicherelement hinzu.
Add(IStorageItem, String)	Fügt der Zugriffsliste ein neues Speicherelement und zugehörige Metadaten hinzu.
AddOrReplace(String, IStorageItem)	Fügt der Zugriffsliste ein neues Speicherelement hinzu oder ersetzt das angegebene Element, wenn es bereits in der Liste vorhanden ist.
AddOrReplace(String, IStorageItem, String)	Fügt der Zugriffsliste ein neues Speicherelement und zugehörige Metadaten hinzu oder ersetzt das angegebene Element, sofern es bereits in der Liste vorhanden ist.
CheckAccess(IStorageItem)	Bestimmt, ob die App Zugriff auf das angegebene Speicherelement in der Zugriffsliste hat.
Clear()	Entfernt alle Speicherelemente aus der Zugriffsliste.
ContainsItem(String)	Bestimmt, ob die Zugriffsliste das angegebene Speicherelement enthält.
GetFileAsync(String)	Ruft die angegebene StorageFile aus der Liste ab.
GetFileAsync(String, AccessCacheOptions)	Ruft die StorageFile mithilfe der angegebenen Optionen aus der Liste ab.
GetFolderAsync(String)	Ruft den angegebenen StorageFolder aus der Liste ab.
GetFolderAsync(String, AccessCacheOptions)	Ruft den angegebenen StorageFolder mithilfe der angegebenen Optionen aus der Liste ab.
GetItemAsync(String)	Ruft das angegebene Element (z. B. eine Datei oder einen Ordner) aus der Liste der zuletzt verwendeten (MRU) ab.
GetItemAsync(String, AccessCacheOptions)	Ruft das angegebene Element (z. B. eine Datei oder einen Ordner) mithilfe der angegebenen Optionen aus der Liste ab.
Remove(String)	Entfernt das angegebene Speicherelement aus der Zugriffsliste.

Weitere Informationen

• FutureAccessList