StorageFolder Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Gestisce cartelle e contenuto e fornisce informazioni su di esse.

public ref class StorageFolder sealed : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolder final : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolder : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations

Public NotInheritable Class StorageFolder
Implements IStorageFolder, IStorageFolder2, IStorageFolderQueryOperations, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

Ereditarietà: Object Platform::Object IInspectable StorageFolder

Attributi: ContractVersionAttribute

Implementazioni: IStorageFolder IStorageFolder2 IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider IStorageFolderQueryOperations

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	documentsLibrary musicLibrary picturesLibrary videosLibrary

Commenti

In genere si ottengono oggetti StorageFolder come valore restituito delle chiamate al metodo asincrone. Ad esempio, il metodo statico GetFolderFromPathAsync restituisce un Oggetto StorageFolder che rappresenta la cartella specificata.

Si noti che quando si chiama una selezione file per consentire all'utente di selezionare una cartella, la selezione file restituisce la cartella come storageFolder.

Non esiste attualmente un metodo "MoveAsync" o simile. Una semplice implementazione dello spostamento di una cartella potrebbe essere quella di ottenere la cartella desiderata, copiarla nel percorso desiderato e quindi eliminare la cartella originale.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1803	17134	TryGetChangeTracker
2004	19041	GetFolderFromPathForUserAsync

Proprietà

Attributes	Ottiene gli attributi della cartella corrente.
DateCreated	Ottiene la data e l'ora di creazione della cartella corrente.
DisplayName	Ottiene il nome descrittivo della cartella corrente.
DisplayType	Ottiene la descrizione descrittiva del tipo della cartella; ad esempio , `JPEG image`.
FolderRelativeId	Ottiene un identificatore per la cartella corrente. Questo ID è univoco per il risultato della query o StorageFolder che contiene la cartella corrente o il gruppo di file e può essere usato per distinguere tra gli elementi con lo stesso nome.
Name	Ottiene il nome della cartella corrente.
Path	Ottiene il percorso completo della cartella corrente nel file system, se il percorso è disponibile.
Properties	Ottiene un oggetto che fornisce l'accesso alle proprietà correlate al contenuto della cartella corrente.
Provider	Ottiene l'oggetto StorageProvider che contiene informazioni sul servizio che archivia la cartella corrente.

Metodi

AreQueryOptionsSupported(QueryOptions)	Indica se la cartella corrente supporta QueryOptions specificata.
CreateFileAsync(String)	Crea un nuovo file con il nome specificato nella cartella corrente.
CreateFileAsync(String, CreationCollisionOption)	Crea un nuovo file nella cartella corrente. Questo metodo specifica anche cosa fare se un file con lo stesso nome esiste già nella cartella corrente.
CreateFileQuery()	Ottiene un oggetto risultato della query contenente i file nella cartella corrente.
CreateFileQuery(CommonFileQuery)	Ottiene un oggetto risultato della query contenente i file nella cartella corrente. Ottiene anche i file dalle sottocartelle della cartella corrente quando il valore dell'argomento di query è diverso da CommonFileQuery.DefaultQuery. I file vengono ordinati in base all'oggetto CommonFileQuery specificato.
CreateFileQueryWithOptions(QueryOptions)	Ottiene un oggetto risultato della query contenente i file nella cartella corrente e, facoltativamente, nelle sottocartelle della cartella corrente. I risultati sono basati su QueryOptions specificati.
CreateFolderAsync(String)	Crea una nuova sottocartella con il nome specificato nella cartella corrente.
CreateFolderAsync(String, CreationCollisionOption)	Crea una nuova sottocartella con il nome specificato nella cartella corrente. Questo metodo specifica anche cosa fare se una sottocartella con lo stesso nome esiste già nella cartella corrente.
CreateFolderQuery()	Ottiene un oggetto risultato della query contenente le sottocartelle nella cartella corrente.
CreateFolderQuery(CommonFolderQuery)	Ottiene un oggetto risultato della query contenente le sottocartelle nella cartella corrente. Quando il valore dell'argomento di query è diverso da CommonFolderQuery.DefaultQuery, ottiene un elenco di cartelle virtuali che rappresentano contenitori per i gruppi di file nelle sottocartelle della cartella corrente. I file vengono raggruppati in cartelle in base al valore specificato dall'enumerazione CommonFolderQuery .
CreateFolderQueryWithOptions(QueryOptions)	Ottiene un oggetto risultato query contenente le sottocartelle nella cartella corrente e, facoltativamente, sottocartelle annidate. I risultati sono basati su QueryOptions specificati.
CreateItemQuery()	Ottiene un oggetto risultato della query contenente i file e le sottocartelle nella cartella corrente.
CreateItemQueryWithOptions(QueryOptions)	Ottiene un oggetto risultato della query contenente i file e le sottocartelle nella cartella corrente e, facoltativamente, nelle sottocartelle della cartella corrente. I risultati sono basati su QueryOptions specificati.
DeleteAsync()	Elimina la cartella corrente.
DeleteAsync(StorageDeleteOption)	Elimina la cartella corrente. Questo metodo specifica anche se eliminare definitivamente la cartella.
GetBasicPropertiesAsync()	Ottiene le proprietà di base della cartella corrente o del gruppo di file.
GetFileAsync(String)	Ottiene il file con il nome specificato dalla cartella corrente.
GetFilesAsync()	Ottiene i file nella cartella corrente.
GetFilesAsync(CommonFileQuery)	Ottiene i file nella cartella corrente. Ottiene anche i file dalle sottocartelle della cartella corrente quando il valore dell'argomento di query è diverso da CommonFileQuery.DefaultQuery. I file vengono ordinati in base al valore specificato dall'enumerazione CommonFileQuery .
GetFilesAsync(CommonFileQuery, UInt32, UInt32)	Ottiene un intervallo di file basato su indice dall'elenco di tutti i file nella cartella corrente. Ottiene anche i file dalle sottocartelle della cartella corrente quando il valore dell'argomento di query è diverso da CommonFileQuery.DefaultQuery. I file vengono ordinati in base al valore specificato dall'enumerazione CommonFileQuery .
GetFolderAsync(String)	Ottiene la sottocartella con il nome specificato dalla cartella corrente.
GetFolderFromPathAsync(String)	Ottiene la cartella con il percorso assoluto specificato nel file system.
GetFolderFromPathForUserAsync(User, String)	Ottiene StorageFolder in base a un percorso assoluto nel file system per un determinato utente.
GetFoldersAsync()	Ottiene le sottocartelle nella cartella corrente.
GetFoldersAsync(CommonFolderQuery)	Ottiene le sottocartelle nella cartella corrente. Quando il valore dell'argomento di query è diverso da CommonFolderQuery.DefaultQuery, ottiene un elenco di cartelle virtuali che rappresentano contenitori per i gruppi di file nelle sottocartelle della cartella corrente. I file vengono raggruppati in cartelle in base al valore specificato dall'enumerazione CommonFolderQuery .
GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)	Ottiene un intervallo di cartelle basato su indice dall'elenco di tutte le sottocartelle nella cartella corrente. Quando il valore dell'argomento di query è diverso da CommonFolderQuery.DefaultQuery, ottiene un elenco di cartelle virtuali che rappresentano contenitori per i gruppi di file nelle sottocartelle della cartella corrente. I file vengono raggruppati in cartelle in base al valore specificato dall'enumerazione CommonFolderQuery .
GetIndexedStateAsync()	Ottiene lo stato indicizzato della cartella corrente.
GetItemAsync(String)	Ottiene il file o la cartella con il nome specificato dalla cartella corrente.
GetItemsAsync()	Ottiene i file e le sottocartelle nella cartella corrente.
GetItemsAsync(UInt32, UInt32)	Ottiene un intervallo basato su indici di file e cartelle dall'elenco di tutti i file e le sottocartelle nella cartella corrente.
GetParentAsync()	Ottiene la cartella padre della cartella corrente.
GetScaledImageAsThumbnailAsync(ThumbnailMode)	Ottiene un'immagine ridimensionata come anteprima, determinata dallo scopo dell'anteprima.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)	Ottiene un'immagine ridimensionata come anteprima, determinata dallo scopo dell'anteprima e delle dimensioni richieste.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Ottiene un'immagine ridimensionata come anteprima, determinata dallo scopo dell'anteprima, delle dimensioni richieste e delle opzioni specificate
GetThumbnailAsync(ThumbnailMode)	Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato dell'anteprima.
GetThumbnailAsync(ThumbnailMode, UInt32)	Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato dell'anteprima e modificata alle dimensioni richieste.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Ottiene un'immagine di anteprima per la cartella corrente, ridimensionata per lo scopo specificato dell'anteprima e modificata alle dimensioni richieste con le opzioni specificate.
IsCommonFileQuerySupported(CommonFileQuery)	Indica se la cartella corrente supporta CommonFileQuery specificata.
IsCommonFolderQuerySupported(CommonFolderQuery)	Indica se la cartella corrente supporta commonFolderQuery specificata.
IsEqual(IStorageItem)	Indica se la cartella corrente è uguale alla cartella specificata.
IsOfType(StorageItemTypes)	Indica se storageFolder corrente corrisponde al valore StorageItemTypes specificato.
RenameAsync(String)	Rinomina la cartella corrente.
RenameAsync(String, NameCollisionOption)	Rinomina la cartella corrente e specifica cosa fare se esiste già una cartella con lo stesso nome.
TryGetChangeTracker()	Ottiene StorageLibraryChangeTracker associato a un oggetto StorageFolder.
TryGetItemAsync(String)	Tenta di ottenere il file o la cartella con il nome specificato dalla cartella corrente. Restituisce Null anziché generare un file FileNotFoundException se il file o la cartella specificata non viene trovato.

Si applica a