StorageFolderQueryResult Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Storage.Search
Modifica

Fornisce l'accesso ai risultati di una query che elenca la cartella (o i gruppi di file) nella cartella in cui viene eseguita una query (rappresentata da un oggetto StorageFolder). È possibile usare un oggetto StorageFolderQueryResult per enumerare cartelle o gruppi di file in tale cartella.

public ref class StorageFolderQueryResult sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolderQueryResult final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolderQueryResult
Public NotInheritable Class StorageFolderQueryResult
Ereditarietà
Object Platform::Object IInspectable StorageFolderQueryResult
Attributi
ContractVersionAttribute
Implementazioni
IStorageQueryResultBase

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

In questo esempio viene illustrato come ottenere cartelle di elenco (o gruppi di file) da un oggetto StorageFolderQueryResult.

// Get the Pictures library
Windows.Storage.StorageFolder picturesLibrary = Windows.Storage.KnownFolders.PicturesLibrary;

// Set query options to create groups of files within result
QueryOptions queryOptions = new QueryOptions(Windows.Storage.Search.CommonFolderQuery.GroupByMonth);

// Create query and retrieve result
StorageFolderQueryResult queryResult = picturesLibrary.CreateFolderQueryWithOptions(queryOptions);
IReadOnlyList<StorageFolder> folders = await queryResult.GetFoldersAsync();
// Process file groups
foreach (StorageFolder folder in folders)
{
    // Get and process files in group
    IReadOnlyList<StorageFile> fileList = await folder.GetFilesAsync();
    OutputPanel.Children.Add(CreateHeaderTextBlock(folder.Name + " (" + fileList.Count + ")"));
    foreach (StorageFile file in fileList)
    {
        // Process file
    }
}

La queryResult variabile ottiene l'oggetto StorageFolderQueryResult usato per recuperare i gruppi di file (o le cartelle) che soddisfano i criteri della query.

Nota

È necessaria la funzionalità libreria Immagini per accedere alla libreria usando KnownFolders.PicturesLibrary. Per altre informazioni sulle funzionalità e sull'accesso ai file, vedere Autorizzazioni di accesso ai file.

Commenti

Nota

Anche se non è attribuito con marshalling_behavior(agile), questa classe può essere considerata agile. Per altre informazioni, vedere Threading e marshalling (C++/CX).

È possibile ottenere un oggetto StorageFolderQueryResult chiamando i metodi seguenti da un oggetto StorageFolder o da un oggetto FolderInformation :

Per altri esempi di codice che illustrano come usare gli oggetti storageFolderQueryResult, vedere l'esempio di enumerazione Folder.

Per ottenere un oggetto StorageFolderQueryResult per enumerare le cartelle o i gruppi di file in un percorso, è necessario ottenere un oggetto storageFolder che rappresenta il percorso e quindi creare una query di cartella.

Proprietà

Folder

Ottiene la cartella usata originariamente per creare l'oggetto StorageFolderQueryResult . Questa cartella rappresenta l'ambito della query.

Metodi

ApplyNewQueryOptions(QueryOptions)

Modifica i risultati delle query in base alla nuova queryOptions.
FindStartIndexAsync(Object)

Recupera l'indice della cartella dai risultati della query che corrispondono più strettamente al valore della proprietà specificato. La proprietà corrispondente è determinata dal primo SortEntry dell'elenco QueryOptions.SortOrder .
GetCurrentQueryOptions()

Recupera le opzioni di query usate per determinare i risultati delle query.
GetFoldersAsync()

Recupera un elenco di tutte le cartelle (o gruppi di file) nel set di risultati.
GetFoldersAsync(UInt32, UInt32)

Recupera cartelle (o gruppi di file) in un intervallo specificato.
GetItemCountAsync()

Recupera il numero di cartelle (o gruppi di file) nel set di risultati della query.

Eventi

ContentsChanged

Viene generato quando viene aggiunto un file a, eliminato o modificato nella cartella in cui viene eseguita una query. Questo evento viene generato solo dopo che GetFilesAsync è stato chiamato almeno una volta.
OptionsChanged

Viene generato quando cambiano le opzioni di query.

Si applica a

Vedi anche