Condividi tramite


StorageFolder Classe

Definizione

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
Implementazioni

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

Vedi anche