StorageFolder.CreateItemQueryWithOptions(QueryOptions) Méthode

Définition

Espace de noms:

Windows.Storage

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.

public:
 virtual StorageItemQueryResult ^ CreateItemQueryWithOptions(QueryOptions ^ queryOptions) = CreateItemQueryWithOptions;

StorageItemQueryResult CreateItemQueryWithOptions(QueryOptions const& queryOptions);

public StorageItemQueryResult CreateItemQueryWithOptions(QueryOptions queryOptions);

function createItemQueryWithOptions(queryOptions)

Public Function CreateItemQueryWithOptions (queryOptions As QueryOptions) As StorageItemQueryResult

Paramètres

queryOptions

QueryOptions

Critères appliqués à la requête.

Retours

StorageItemQueryResult

Objet de résultat de requête. Appelez la méthode GetItemsAsync du résultat de la requête pour obtenir les fichiers et sous-dossiers dans le dossier actif et, éventuellement, dans les sous-dossiers du dossier actif, filtrés et triés en fonction des QueryOptions spécifiés. Cette méthode retourne une liste de type IReadOnlyList<IStorageItem>. Chaque fichier ou dossier est représenté par un élément de type IStorageItem.

Pour utiliser les éléments retournés, appelez la méthode IsOfType de l’interface IStorageItem pour déterminer si chaque élément est un fichier ou un dossier. Ensuite, effectuez un cast de l’élément en storageFolder ou StorageFile.

Implémente

CreateItemQueryWithOptions(QueryOptions)

Exceptions

UnauthorizedAccessException

Vous n’êtes pas autorisé à accéder au contenu du dossier actif.

ArgumentException

Vous avez spécifié une valeur autre que DefaultQuery à partir de l’énumération <xref:Windows.Storage.Search.CommonFileQuery?text=CommonFileQuery> ou <xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery> pour un dossier qui n’est pas un dossier de bibliothèque.

Remarques

Pour obtenir plus d’informations et des exemples sur l’obtention d’objets de résultats de requête, consultez CreateFileQueryWithOptions.