StorageFileQueryResult Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage.Search

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

Fornisce l'accesso ai risultati di una query dei file nel percorso rappresentato da un oggetto StorageFolder . È possibile usare StorageFileQueryResult per enumerare i file nel percorso StorageFolder .

public ref class StorageFileQueryResult sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFileQueryResult final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFileQueryResult

Public NotInheritable Class StorageFileQueryResult

Ereditarietà: Object Platform::Object IInspectable StorageFileQueryResult

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 un elenco di file da un oggetto StorageFileQueryResult.

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Process file
}

La query variabile ottiene l'oggetto StorageFileQueryResult usato per recuperare i file che soddisfano i criteri della query.

Nota

È necessaria la funzionalità raccolta 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 a marshalling_behavior(agile), questa classe può essere considerata agile.

Puoi ottenere un oggetto StorageFileQueryResult chiamando i metodi seguenti da un oggetto StorageFolder o FolderInformation :

Proprietà

Folder

Ottiene la cartella su cui è stata eseguita una query per creare l'oggetto StorageFileQueryResult . Questa cartella rappresenta l'ambito della query.

Metodi

ApplyNewQueryOptions(QueryOptions)	Modifica i risultati delle query in base alle nuove opzioni query.
FindStartIndexAsync(Object)	Recupera l'indice del file dai risultati della query che corrispondono più strettamente al valore della proprietà specificato (o file, se usato con FileActivatedEventArgs.NeighboringFilesQuery). La proprietà corrispondente è determinata dalla prima proprietà SortEntry dell'elenco QueryOptions.SortOrder .
GetCurrentQueryOptions()	Recupera le opzioni di query utilizzate per determinare i risultati della query.
GetFilesAsync()	Recupera un elenco di tutti i file nel set di risultati della query.
GetFilesAsync(UInt32, UInt32)	Recupera un elenco di file in un intervallo specificato.
GetItemCountAsync()	Recupera il numero di file nel set di risultati della query.
GetMatchingPropertiesWithRanges(StorageFile)	Ottiene le proprietà dei file corrispondenti con gli intervalli di testo corrispondenti.

Eventi

ContentsChanged	Viene generato quando un file viene aggiunto, eliminato o modificato nella cartella su 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

Condividi tramite