StorageFolder Classe

Référence

Définition

Espace de noms:: Windows.Storage

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Gère les dossiers et leur contenu et fournit des informations les concernant.

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

Héritage: Object Platform::Object IInspectable StorageFolder

Attributs: ContractVersionAttribute

Implémente: IStorageFolder IStorageFolder2 IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider IStorageFolderQueryOperations

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	documentsLibrary musicLibrary picturesLibrary videosLibrary

Remarques

En règle générale, vous obtenez des objets StorageFolder comme valeur de retour des appels de méthode asynchrones. Par exemple, la méthode statique GetFolderFromPathAsync retourne un StorageFolder qui représente le dossier spécifié.

Notez que lorsque vous appelez un sélecteur de fichiers pour permettre à l’utilisateur de choisir un dossier, le sélecteur de fichiers retourne le dossier en tant que StorageFolder.

Il n’existe actuellement pas de méthode « MoveAsync » ou similaire. Une implémentation simple du déplacement d’un dossier peut être d’obtenir le dossier souhaité, de le copier à l’emplacement souhaité, puis de supprimer le dossier d’origine.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1803	17134	TryGetChangeTracker
2004	19041	GetFolderFromPathForUserAsync

Propriétés

Attributes	Obtient les attributs du dossier actif.
DateCreated	Obtient la date et l’heure de création du dossier actif.
DisplayName	Obtient le nom convivial du dossier actif.
DisplayType	Obtient la description conviviale du type du dossier ; par exemple, `JPEG image`.
FolderRelativeId	Obtient un identificateur pour le dossier actif. Cet ID est unique pour le résultat de la requête ou StorageFolder qui contient le dossier ou le groupe de fichiers actif, et peut être utilisé pour faire la distinction entre les éléments portant le même nom.
Name	Obtient le nom du dossier actif.
Path	Obtient le chemin d’accès complet du dossier actif dans le système de fichiers, si le chemin d’accès est disponible.
Properties	Obtient un objet qui fournit l’accès aux propriétés liées au contenu du dossier actif.
Provider	Obtient l’objet StorageProvider qui contient des informations sur le service qui stocke le dossier actif.

Méthodes

AreQueryOptionsSupported(QueryOptions)	Indique si le dossier actif prend en charge les QueryOptions spécifiés.
CreateFileAsync(String)	Crée un fichier avec le nom spécifié dans le dossier actif.
CreateFileAsync(String, CreationCollisionOption)	Crée un fichier dans le dossier actif. Cette méthode spécifie également ce qu’il faut faire si un fichier portant le même nom existe déjà dans le dossier actif.
CreateFileQuery()	Obtient un objet de résultat de requête qui contient les fichiers dans le dossier actif.
CreateFileQuery(CommonFileQuery)	Obtient un objet de résultat de requête qui contient les fichiers dans le dossier actif. Obtient également les fichiers des sous-dossiers du dossier actif lorsque la valeur de l’argument de requête est autre que CommonFileQuery.DefaultQuery. Les fichiers sont triés en fonction du CommonFileQuery spécifié.
CreateFileQueryWithOptions(QueryOptions)	Obtient un objet de résultat de requête qui contient les fichiers dans le dossier actif et, éventuellement, dans les sous-dossiers du dossier actif. Les résultats sont basés sur les QueryOptions spécifiées.
CreateFolderAsync(String)	Crée un sous-dossier avec le nom spécifié dans le dossier actif.
CreateFolderAsync(String, CreationCollisionOption)	Crée un sous-dossier avec le nom spécifié dans le dossier actif. Cette méthode spécifie également ce qu’il faut faire si un sous-dossier portant le même nom existe déjà dans le dossier actif.
CreateFolderQuery()	Obtient un objet de résultat de requête qui contient les sous-dossiers du dossier actif.
CreateFolderQuery(CommonFolderQuery)	Obtient un objet de résultat de requête qui contient les sous-dossiers du dossier actif. Lorsque la valeur de l’argument de requête est autre que CommonFolderQuery.DefaultQuery, obtient une liste de dossiers virtuels qui représentent des conteneurs pour les groupes de fichiers dans les sous-dossiers du dossier actif. Les fichiers sont regroupés dans des dossiers en fonction de la valeur spécifiée de l’énumération CommonFolderQuery .
CreateFolderQueryWithOptions(QueryOptions)	Obtient un objet de résultat de requête qui contient les sous-dossiers dans le dossier actif et, éventuellement, les sous-dossiers imbriqués. Les résultats sont basés sur les QueryOptions spécifiées.
CreateItemQuery()	Obtient un objet de résultat de requête qui contient les fichiers et sous-dossiers du dossier actif.
CreateItemQueryWithOptions(QueryOptions)	Obtient un objet de résultat de requête qui contient les fichiers et sous-dossiers dans le dossier actif et, éventuellement, dans les sous-dossiers du dossier actif. Les résultats sont basés sur les QueryOptions spécifiées.
DeleteAsync()	Supprime le dossier actif.
DeleteAsync(StorageDeleteOption)	Supprime le dossier actif. Cette méthode spécifie également s’il faut supprimer définitivement le dossier.
GetBasicPropertiesAsync()	Obtient les propriétés de base du dossier ou du groupe de fichiers actif.
GetFileAsync(String)	Obtient le fichier portant le nom spécifié à partir du dossier actif.
GetFilesAsync()	Obtient les fichiers du dossier actif.
GetFilesAsync(CommonFileQuery)	Obtient les fichiers du dossier actif. Obtient également les fichiers des sous-dossiers du dossier actif lorsque la valeur de l’argument de requête est autre que CommonFileQuery.DefaultQuery. Les fichiers sont triés en fonction de la valeur spécifiée de l’énumération CommonFileQuery .
GetFilesAsync(CommonFileQuery, UInt32, UInt32)	Obtient une plage de fichiers basée sur un index de la liste de tous les fichiers du dossier actif. Obtient également les fichiers des sous-dossiers du dossier actif lorsque la valeur de l’argument de requête est autre que CommonFileQuery.DefaultQuery. Les fichiers sont triés en fonction de la valeur spécifiée de l’énumération CommonFileQuery .
GetFolderAsync(String)	Obtient le sous-dossier avec le nom spécifié à partir du dossier actif.
GetFolderFromPathAsync(String)	Obtient le dossier qui a le chemin d’accès absolu spécifié dans le système de fichiers.
GetFolderFromPathForUserAsync(User, String)	Obtient le StorageFolder en fonction d’un chemin d’accès absolu dans le système de fichiers pour un utilisateur donné.
GetFoldersAsync()	Obtient les sous-dossiers du dossier actif.
GetFoldersAsync(CommonFolderQuery)	Obtient les sous-dossiers du dossier actif. Lorsque la valeur de l’argument de requête est autre que CommonFolderQuery.DefaultQuery, obtient une liste de dossiers virtuels qui représentent des conteneurs pour les groupes de fichiers dans les sous-dossiers du dossier actif. Les fichiers sont regroupés dans des dossiers en fonction de la valeur spécifiée de l’énumération CommonFolderQuery .
GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)	Obtient une plage de dossiers basée sur un index à partir de la liste de tous les sous-dossiers du dossier actif. Lorsque la valeur de l’argument de requête est autre que CommonFolderQuery.DefaultQuery, obtient une liste de dossiers virtuels qui représentent des conteneurs pour les groupes de fichiers dans les sous-dossiers du dossier actif. Les fichiers sont regroupés dans des dossiers en fonction de la valeur spécifiée de l’énumération CommonFolderQuery .
GetIndexedStateAsync()	Obtient l’état indexé du dossier actif.
GetItemAsync(String)	Obtient le fichier ou le dossier portant le nom spécifié à partir du dossier actif.
GetItemsAsync()	Obtient les fichiers et sous-dossiers dans le dossier actif.
GetItemsAsync(UInt32, UInt32)	Obtient une plage basée sur un index de fichiers et de dossiers à partir de la liste de tous les fichiers et sous-dossiers du dossier actif.
GetParentAsync()	Obtient le dossier parent du dossier actif.
GetScaledImageAsThumbnailAsync(ThumbnailMode)	Obtient une image mise à l’échelle en tant que miniature, déterminée par l’objectif de la miniature.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)	Obtient une image mise à l’échelle en tant que miniature, déterminée par l’objectif de la miniature et la taille demandée.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Obtient une image mise à l’échelle en tant que miniature, déterminée par l’objectif de la miniature, la taille demandée et les options spécifiées
GetThumbnailAsync(ThumbnailMode)	Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié de la miniature.
GetThumbnailAsync(ThumbnailMode, UInt32)	Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié de la miniature et ajustée à la taille demandée.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Obtient une image miniature pour le dossier actif, dimensionnée pour l’objectif spécifié de la miniature et ajustée à la taille demandée avec les options spécifiées.
IsCommonFileQuerySupported(CommonFileQuery)	Indique si le dossier actif prend en charge le CommonFileQuery spécifié.
IsCommonFolderQuerySupported(CommonFolderQuery)	Indique si le dossier actif prend en charge le CommonFolderQuery spécifié.
IsEqual(IStorageItem)	Indique si le dossier actif est égal au dossier spécifié.
IsOfType(StorageItemTypes)	Indique si le StorageFolder actuel correspond à la valeur StorageItemTypes spécifiée.
RenameAsync(String)	Renomme le dossier actif.
RenameAsync(String, NameCollisionOption)	Renomme le dossier actif et spécifie ce qu’il faut faire si un dossier portant le même nom existe déjà.
TryGetChangeTracker()	Obtient le StorageLibraryChangeTracker associé à un StorageFolder.
TryGetItemAsync(String)	Tente d’obtenir le fichier ou le dossier portant le nom spécifié à partir du dossier actif. Retourne null au lieu de déclencher une exception FileNotFoundException si le fichier ou dossier spécifié est introuvable.

S’applique à