Espandi Riduci a icona

StorageFolder Class

Modifica le cartelle e il relativo contenuto e fornisce informazioni su di esse.

Sintassi


var storageFolder = Windows.Storage.StorageFolder;

Attributi

[Version(0x06020000)]

Membri

Il StorageFolderClasse dispone di questi tipi di membri:

Metodi

The StorageFolder Classe dispone di questi metodi. Con C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

MetodoDescrizione
AreQueryOptionsSupported Determines whether the current folder supports the specified QueryOptions.
CreateFileAsync(String) Creates a new file in the folder or file group.
CreateFileAsync(String, CreationCollisionOption) Creates a new file in the current folder, and specifies what to do if a file with the same name already exists in the current folder.
CreateFileQuery() Creates a query result object to filter and enumerate top-level files in the current folder.
CreateFileQuery(CommonFileQuery) Creates a query result object to filter and enumerate all the files in the current folder and its subfolders. Files are filtered and sorted based on the specified CommonFileQuery.
CreateFileQueryWithOptions Creates a query result object to filter and enumerate the files in the current folder and its subfolders. Files are included in the query result and sorted based on the specified QueryOptions.
CreateFolderAsync(String) Creates a new subfolder inside the current folder.
CreateFolderAsync(String, CreationCollisionOption) Creates a new sub-folder inside the current folder, and specifies what to do if a folder with the same name already exists in the current folder.
CreateFolderQuery() Creates a query result object to filter and enumerate top-level sub-folders of the current folder.
CreateFolderQuery(CommonFolderQuery) Creates a query result object to enumerate files in the current folder by grouping them into StorageFolder objects. Files are filtered and grouped based on the specified CommonFolderQuery.
CreateFolderQueryWithOptions Creates a query result object to filter and enumerate files in the current folder by grouping them into sub-folders. Files are included in the query result and grouped into sub-folders based on the specified QueryOptions.
CreateItemQuery Creates a query result object to filter and enumerate top-level items (files and sub-folders) in the current folder.
CreateItemQueryWithOptions Creates a query result object to filter and enumerate top-level items (files and sub-folders) in the current folder. Items are included in the query result and sorted based on the specified QueryOptions.
DeleteAsync() Deletes the current folder or file group.
DeleteAsync(StorageDeleteOption) Deletes the current folder or file group, optionally deleting it permanently.
GetBasicPropertiesAsync Gets the basic properties of the current folder or file group.
GetFileAsync Gets a single file from the current folder using the specified file name.
GetFilesAsync() Gets the top-level files in the current folder.
GetFilesAsync(CommonFileQuery) Gets a list of all files in the current folder and its sub-folders. Files are filtered and sorted based on the specified CommonFileQuery.
GetFilesAsync(CommonFileQuery, UInt32, UInt32) Gets an index-based range of files from the list of all files in the current the current folder and its sub-folders. Files are filtered and sorted based on the specified CommonFileQuery and are included in the range based on the resulting indexes.
GetFolderAsync Gets a single sub-folder from the current folder using the specified folder name.
GetFolderFromPathAsync Gets a StorageFolder that represents the folder at the specified file-system path.
GetFoldersAsync() Gets a list of the top-level sub-folders of the current folder.
GetFoldersAsync(CommonFolderQuery) Gets a list of StorageFolder objects that represent groups of files in the current folder. Files are filtered and grouped based on the specified CommonFolderQuery.
GetFoldersAsync(CommonFolderQuery, UInt32, UInt32) Gets an index-based range of StorageFolder objects that represent groups of files in the current folder. Files are filtered and grouped based on the specified CommonFolderQuery and are included in the range based on the resulting indexes.
GetIndexedStateAsync Gets the indexed state of the current folder.
GetItemAsync Gets a single file or sub-folder from the current folder using the name of the item.
GetItemsAsync() Gets a list of top-level files and sub-folders inside the current folder.
GetItemsAsync(UInt32, UInt32) Gets an index-based range from a list of all the files and sub-folders inside the current folder. Items in the range based on the resulting indexes.
GetParentAsync Gets the parent folder of the current folder.
GetScaledImageAsThumbnailAsync(ThumbnailMode) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail and the requested size.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail, the requested size, and the specified options
GetThumbnailAsync(ThumbnailMode) Gets an adjusted thumbnail image for the current folder, determined by the specified purpose of the thumbnail.
GetThumbnailAsync(ThumbnailMode, UInt32) Gets an adjusted thumbnail image for the current folder, determined by the specified purpose of the thumbnail and the requested size.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) Gets an adjusted thumbnail image for the current folder, determined by the specified purpose of the thumbnail, the requested size, and the specified options.
IsCommonFileQuerySupported Indicates whether the current folder supports the specified CommonFileQuery.
IsCommonFolderQuerySupported Indicates whether the current folder supports the specified CommonFolderQuery.
IsEqual Indicates whether the current folder is equal to the specified folder.
IsOfType Indicates whether the current StorageFolder matches the specified StorageItemTypes value.
RenameAsync(String) Renames the current folder.
RenameAsync(String, NameCollisionOption) Renames the current folder and specifies what to do if a folder with the same name already exists.
TryGetItemAsync Try to get a single file or sub-folder from the current folder by using the name of the item.

 

Proprietà

Il StorageFolderClasse dispone di queste proprietà.

ProprietàTipo accessoDescrizione

Attributes

Sola letturaGets the attributes of the current folder.

DateCreated

Sola letturaGets the date and time that the current folder was created.

DisplayName

Sola letturaGets the user-friendly name of the current folder.

DisplayType

Sola letturaGets the user-friendly type of the folder or file group.

FolderRelativeId

Sola letturaGets an identifier for the current folder. This ID is unique for the query result or StorageFolder that contains the current folder or file group, and can be used to distinguish between items that have the same name.

Name

Sola letturaGets the name of the current folder.

Path

Sola letturaGets the full file-system path of the current folder, if the folder has a path.

Properties

Sola letturaGets an object that provides access to the content-related properties of the current folder.

Provider

Sola letturaGets the StorageProvider object that contains info about the service that stores the current folder.

 

Osservazioni

In genere, è possibile accedere agli oggetti StorageFolder come risultato di un metodo asincrono e/o di chiamate di funzione. Ad esempio, il metodo statico GetFolderFromPathAsync restituisce un oggetto StorageFolder che rappresenta la cartella specificata.

Inoltre, ogni volta che viene chiamato un selettore file per consentire all'utente la selezione di una cartella, il selettore in questione restituirà la cartella come oggetto StorageFolder.

Esempi

In questo esempio viene illustrato come chiamare un selettore file utilizzando FolderPicker.PickSingleFolderAsync per acquisire e elaborare un file selezionato dagli utenti.



folderPicker.pickSingleFolderAsync().then(function (folder) {
   if (folder) {
       // Process picked folder

       // Store folder for future access
       var folderToken = Windows.Storage.AccessCache.StorageApplicationPermissions.futureAccessList.add(folder);
   } else {
       // The user didn't pick a folder
   }
});

Dopo il completamento di PickSingleFileAsync, folder ottiene il file selezionato come StorageFolder.

Nell'esempio, folderPicker contiene un oggetto FolderPicker. Per informazioni sull'utilizzo dei selettori file, consultare FolderPicker e Guida introduttiva: Accesso a file con selezioni file .

Inoltre, l'oggetto folderToken ottiene un identificatore utilizzabile per il recupero della cartella dall'oggetto FutureAccessList. Per ulteriori informazioni su come memorizzare i file e le cartelle in modo da potervi eseguire l'accesso successivamente, vedere FutureAccessList, MostRecentlyUsedList e Modalità di rilevamento dei file e delle cartelle usati di recente.

Requisiti

Client minimo supportato

Windows 8 [solo app di Windows Store]

Server minimo supportato

Windows Server 2012 [solo app di Windows Store]

Telefono minimo supportato

Windows Phone 8

Spazio dei nomi

Windows.Storage
Windows::Storage [C++]

Metadati

Windows.winmd

Capabilities

picturesLibrary
videosLibrary
musicLibrary
documentsLibrary

Vedi anche

StorageFile

 

 

Mostra:
© 2014 Microsoft