IStorageItemAccessList
IStorageItemAccessList
IStorageItemAccessList
IStorageItemAccessList
Interface
Definition
Represents a list of storage items that the app has stored for efficient future access.
public : interface IStorageItemAccessListpublic interface IStorageItemAccessListPublic Interface IStorageItemAccessList// You can use this interface in JavaScript.
- Attributes
| Device family |
Windows 10 (introduced v10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced v1)
|
Properties
Entries Entries Entries Entries
Gets an object for retrieving storage items from the access list.
public : AccessListEntryView Entries { get; }public AccessListEntryView Entries { get; }Public ReadOnly Property Entries As AccessListEntryView// You can use this property in JavaScript.
The object for retrieving storage items.
MaximumItemsAllowed MaximumItemsAllowed MaximumItemsAllowed MaximumItemsAllowed
Gets the maximum number of storage items that the access list can contain.
public : unsigned int MaximumItemsAllowed { get; }public uint MaximumItemsAllowed { get; }Public ReadOnly Property MaximumItemsAllowed As uint// You can use this property in JavaScript.
- Value
- unsigned int uint uint uint
The maximum number of storage items.
Methods
Add(IStorageItem) Add(IStorageItem) Add(IStorageItem) Add(IStorageItem)
Adds a new storage item to the access list.
public : PlatForm::String Add(IStorageItem file)public string Add(IStorageItem file)Public Function Add(file As IStorageItem) As string// You can use this method in JavaScript.
The storage item to add.
A token that the app can use later to retrieve the storage item.
- See Also
Add(IStorageItem, String) Add(IStorageItem, String) Add(IStorageItem, String) Add(IStorageItem, String)
Adds a new storage item and accompanying metadata to the access list.
public : PlatForm::String Add(IStorageItem file, PlatForm::String metadata)public string Add(IStorageItem file, String metadata)Public Function Add(file As IStorageItem, metadata As String) As string// You can use this method in JavaScript.
The storage item to add.
- metadata
- PlatForm::String String String String
Optional metadata to associate with the storage item.
A token that the app can use later to retrieve the storage item.
- See Also
AddOrReplace(String, IStorageItem) AddOrReplace(String, IStorageItem) AddOrReplace(String, IStorageItem) AddOrReplace(String, IStorageItem)
Adds a new storage item to the access list, or replaces the specified item if it already exists in the list.
public : void AddOrReplace(PlatForm::String token, IStorageItem file)public void AddOrReplace(String token, IStorageItem file)Public Function AddOrReplace(token As String, file As IStorageItem) As void// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token associated with the new storage item. If the access list already contains a storage item that has this token, the new item replaces the existing one.
The storage item to add or replace.
- See Also
AddOrReplace(String, IStorageItem, String) AddOrReplace(String, IStorageItem, String) AddOrReplace(String, IStorageItem, String) AddOrReplace(String, IStorageItem, String)
Adds a new storage item and accompanying metadata to the access list, or replaces the specified item if it already exists in the list.
public : void AddOrReplace(PlatForm::String token, IStorageItem file, PlatForm::String metadata)public void AddOrReplace(String token, IStorageItem file, String metadata)Public Function AddOrReplace(token As String, file As IStorageItem, metadata As String) As void// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token associated with the new storage item. If the access list already contains a storage item that has this token, the new item replaces the existing one.
The storage item to add or replace.
- metadata
- PlatForm::String String String String
Optional metadata to associate with the storage item.
- See Also
CheckAccess(IStorageItem) CheckAccess(IStorageItem) CheckAccess(IStorageItem) CheckAccess(IStorageItem)
Determines whether the app has access to the specified storage item in the access list.
public : PlatForm::Boolean CheckAccess(IStorageItem file)public bool CheckAccess(IStorageItem file)Public Function CheckAccess(file As IStorageItem) As bool// You can use this method in JavaScript.
The storage item to check for access.
True if the app can access the storage item; otherwise false.
Clear() Clear() Clear() Clear()
Removes all storage items from the access list.
public : void Clear()public void Clear()Public Function Clear() As void// You can use this method in JavaScript.
ContainsItem(String) ContainsItem(String) ContainsItem(String) ContainsItem(String)
Determines whether the access list contains the specified storage item.
public : PlatForm::Boolean ContainsItem(PlatForm::String token)public bool ContainsItem(String token)Public Function ContainsItem(token As String) As bool// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token of the storage item to look for.
True if the access list contains the specified storage item; false otherwise.
GetFileAsync(String) GetFileAsync(String) GetFileAsync(String) GetFileAsync(String)
Retrieves the specified StorageFile from the list.
public : IAsyncOperation<StorageFile> GetFileAsync(PlatForm::String token)public IAsyncOperation<StorageFile> GetFileAsync(String token)Public Function GetFileAsync(token As String) As IAsyncOperation( Of StorageFile )// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token of the StorageFile to retrieve.
When this method completes successfully, it returns the StorageFile that is associated with the specified token.
- See Also
GetFileAsync(String, AccessCacheOptions) GetFileAsync(String, AccessCacheOptions) GetFileAsync(String, AccessCacheOptions) GetFileAsync(String, AccessCacheOptions)
Retrieves the specified StorageFile from the list using the specified options.
public : IAsyncOperation<StorageFile> GetFileAsync(PlatForm::String token, AccessCacheOptions options)public IAsyncOperation<StorageFile> GetFileAsync(String token, AccessCacheOptions options)Public Function GetFileAsync(token As String, options As AccessCacheOptions) As IAsyncOperation( Of StorageFile )// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token of the StorageFile to retrieve.
The enum value that describes the behavior to use when the app accesses the item.
When this method completes successfully, it returns the StorageFile that is associated with the specified token.
- See Also
GetFolderAsync(String) GetFolderAsync(String) GetFolderAsync(String) GetFolderAsync(String)
Retrieves the specified StorageFolder from the list.
public : IAsyncOperation<StorageFolder> GetFolderAsync(PlatForm::String token)public IAsyncOperation<StorageFolder> GetFolderAsync(String token)Public Function GetFolderAsync(token As String) As IAsyncOperation( Of StorageFolder )// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token of the StorageFolder to retrieve.
When this method completes successfully, it returns the StorageFolder that is associated with the specified token.
- See Also
GetFolderAsync(String, AccessCacheOptions) GetFolderAsync(String, AccessCacheOptions) GetFolderAsync(String, AccessCacheOptions) GetFolderAsync(String, AccessCacheOptions)
Retrieves the specified StorageFolder from the list using the specified options.
public : IAsyncOperation<StorageFolder> GetFolderAsync(PlatForm::String token, AccessCacheOptions options)public IAsyncOperation<StorageFolder> GetFolderAsync(String token, AccessCacheOptions options)Public Function GetFolderAsync(token As String, options As AccessCacheOptions) As IAsyncOperation( Of StorageFolder )// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token of the StorageFolder to retrieve.
The enum value that describes the behavior to use when the app accesses the item.
When this method completes successfully, it returns the StorageFolder that is associated with the specified token.
- See Also
GetItemAsync(String) GetItemAsync(String) GetItemAsync(String) GetItemAsync(String)
Retrieves the specified item (like a file or folder) from the list.
public : IAsyncOperation<IStorageItem> GetItemAsync(PlatForm::String token)public IAsyncOperation<IStorageItem> GetItemAsync(String token)Public Function GetItemAsync(token As String) As IAsyncOperation( Of IStorageItem )// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token of the item to retrieve.
When this method completes successfully, it returns the item (type IStorageItem ) that is associated with the specified token.
- See Also
GetItemAsync(String, AccessCacheOptions) GetItemAsync(String, AccessCacheOptions) GetItemAsync(String, AccessCacheOptions) GetItemAsync(String, AccessCacheOptions)
Retrieves the specified item (like a file or folder) from the list using the specified options.
public : IAsyncOperation<IStorageItem> GetItemAsync(PlatForm::String token, AccessCacheOptions options)public IAsyncOperation<IStorageItem> GetItemAsync(String token, AccessCacheOptions options)Public Function GetItemAsync(token As String, options As AccessCacheOptions) As IAsyncOperation( Of IStorageItem )// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token of the item to retrieve.
The enum value that describes the behavior to use when the app accesses the item.
When this method completes successfully, it returns the item (type IStorageItem ) that is associated with the specified token.
- See Also
Remove(String) Remove(String) Remove(String) Remove(String)
Removes the specified storage item from the access list.
public : void Remove(PlatForm::String token)public void Remove(String token)Public Function Remove(token As String) As void// You can use this method in JavaScript.
- token
- PlatForm::String String String String
The token of the storage item to remove.