StorageFolder.GetFilesAsync Metodo
Definizione
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.
Overload
| 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 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 query è diverso da CommonFileQuery.DefaultQuery. I file vengono ordinati in base al valore specificato dall'enumerazione CommonFileQuery . |
GetFilesAsync()
Ottiene i file nella cartella corrente.
public:
virtual IAsyncOperation<IVectorView<StorageFile ^> ^> ^ GetFilesAsync() = GetFilesAsync;/// [Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultOptionsStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFile>> GetFilesAsync();[Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultOptionsStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFile>> GetFilesAsync();function getFilesAsync()Public Function GetFilesAsync () As IAsyncOperation(Of IReadOnlyList(Of StorageFile))Restituisce
Al termine di questo metodo, restituisce un elenco dei file nella cartella corrente. L'elenco è di tipo IReadOnlyList<StorageFile>. Ogni file nell'elenco è rappresentato da un oggetto StorageFile .
Implementazioni
- Attributi
Eccezioni
Non si dispone dell'autorizzazione per accedere al contenuto della cartella corrente. Per altre informazioni, vedere Autorizzazioni di accesso ai file.
Esempio
Nell'esempio seguente viene illustrato come ottenere il contenuto della cartella Pictures dell'utente e delle relative sottocartelle, ordinate in base alla data, chiamando il metodo di overload GetFilesAsync(CommonFileQuery, UInt32, UInt32). In questo esempio viene restituito un massimo di 20 file, a partire dal file in corrispondenza dell'indice 0. Poiché l'opzione CommonFileQuery.OrderByDate ordina le date in ordine decrescente , ovvero dal più recente al meno recente, questo esempio restituisce le 20 foto più recenti dell'utente.
Prima di eseguire l'esempio seguente, abilitare la funzionalità Raccolta immagini nel file manifesto dell'app.
using Windows.Storage;
using Windows.Storage.Search;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to Output window.
// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;
// Get the first 20 files in the current folder, sorted by date.
IReadOnlyList<StorageFile> sortedItems = await picturesFolder.GetFilesAsync(CommonFileQuery.OrderByDate,0,20);
// Iterate over the results and print the list of files
// to the Visual Studio Output window.
foreach (StorageFile file in sortedItems)
Debug.WriteLine(file.Name + ", " + file.DateCreated);
#include <winrt/Windows.Storage.h>
#include <winrt/Windows.Storage.Search.h>
...
IAsyncAction ExampleCoroutineAsync()
{
// Get the user's Pictures library.
// Enable the Pictures Library capability in the app manifest file.
Windows::Storage::StorageFolder picturesLibrary{ Windows::Storage::KnownFolders::PicturesLibrary() };
// Get the first 20 sorted images in the library, sorted by date.
Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFile> filesInFolder{
co_await picturesLibrary.GetFilesAsync(Windows::Storage::Search::CommonFileQuery::OrderByDate, 0, 20) };
// Iterate over the results, and print the list of files to the Visual Studio output window.
for (Windows::Storage::StorageFile const& fileInFolder : filesInFolder)
{
std::wstring output{ fileInFolder.Name() + L' ' };
::OutputDebugString(output.c_str());
}
::OutputDebugString(L"\n");
}
// Get user's pictures library
StorageFolder^ picturesLibrary = KnownFolders::PicturesLibrary;
// Get the first 20 sorted images in the library
create_task(picturesLibrary->GetFilesAsync(CommonFileQuery::OrderByDate,0,20)).then([=](IVectorView<StorageFile^>^ filesInFolder) {
//Iterate over the results and print the list of files
// to the visual studio output window
for (auto it = filesInFolder->First(); it->HasCurrent; it->MoveNext())
{
StorageFile^ file = it->Current;
String^ output = file->Name + "\n";
OutputDebugString(output->Begin());
}
});
Commenti
Questa query è una query superficiale che restituisce solo i file nella cartella corrente. Per un elenco di metodi che identificano query superficiali e query approfondite, vedere la sezione Osservazioni nell'argomento GetFilesAsync.
Nella tabella seguente sono elencati i metodi della classe StorageFolder che ottengono un elenco di file. La tabella identifica le query superficiali che restituiscono solo file dalla cartella corrente e query approfondite che restituiscono file dalla cartella corrente e dalle relative sottocartelle.
Alcuni metodi accettano un valore dall'enumerazione CommonFileQuery . Quando si specifica l'opzione DefaultQuery dall'enumerazione CommonFileQuery , la query è una query superficiale che restituisce solo i file nella cartella corrente. Quando si specifica un altro valore dall'enumerazione CommonFileQuery , la query è una query completa che restituisce un elenco flat di file dalla cartella corrente e dalle relative sottocartelle.
Suggerimento
Alcuni valori dell'enumerazione CommonFileQuery possono essere usati solo con una cartella di libreria ,ad esempio la raccolta Immagini, o la cartella Homegroup. Oltre all'opzione DefaultQuery , è possibile usare solo le opzioni OrderByName e OrderBySearchRank con una cartella che non è una cartella di libreria.
Per ottenere risultati di query approfonditi da una cartella che non è una cartella di libreria, chiamare il metodo CreateFileQueryWithOptions(QueryOptions) e specificare Deep come valore della proprietà FolderDepth dell'oggetto QueryOptions .
| Metodo | Creare una query superficiale che restituisce solo file dalla cartella corrente | Creare una query approfondita che restituisce i file dalla cartella corrente e dalle relative sottocartelle |
|---|---|---|
| GetFilesAsync() | Comportamento predefinito di questo metodo. | N/D |
| GetFilesAsync(CommonFileQuery) | Specificare l'opzione DefaultQuery . | Per una cartella di libreria, specificare un'opzione diversa da DefaultQuery. |
| GetFilesAsync(CommonFileQuery, UInt32, UInt32) | Specificare l'opzione DefaultQuery . | Per una cartella di libreria, specificare un'opzione diversa da DefaultQuery. |
| CreateFileQuery() | Comportamento predefinito di questo metodo. | N/D |
| CreateFileQuery(CommonFileQuery) | Specificare l'opzione DefaultQuery . | Per una cartella di libreria, specificare un'opzione diversa da DefaultQuery. |
| CreateFileQueryWithOptions(QueryOptions) | Comportamento predefinito di questo metodo se non viene specificata alcuna delle opzioni seguenti. - oppure - Specificare DefaultQuery come valore di CommonFileQuery quando si crea un'istanza dell'oggetto QueryOptions . - oppure - Specificare Shallow come valore della proprietà FolderDepth dell'oggetto QueryOptions. |
Per una cartella di libreria, specificare un valore diverso da DefaultQuery come valore di CommonFileQuery quando si crea un'istanza dell'oggetto QueryOptions . - oppure - Per qualsiasi cartella, specificare Deep come valore della proprietà FolderDepth di QueryOptions. |
Vedi anche
- GetFilesAsync(CommonFileQuery, UInt32, UInt32)
- GetFilesAsync(CommonFileQuery)
- Autorizzazioni di accesso ai file
- GetItemsAsync
Si applica a
GetFilesAsync(CommonFileQuery)
Ottiene i file nella cartella corrente. Ottiene anche i file dalle sottocartelle della cartella corrente quando il valore dell'argomento query è diverso da CommonFileQuery.DefaultQuery. I file vengono ordinati in base al valore specificato dall'enumerazione CommonFileQuery .
public:
virtual IAsyncOperation<IVectorView<StorageFile ^> ^> ^ GetFilesAsync(CommonFileQuery query) = GetFilesAsync;/// [Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFile>> GetFilesAsync(CommonFileQuery const& query);[Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFile>> GetFilesAsync(CommonFileQuery query);function getFilesAsync(query)Public Function GetFilesAsync (query As CommonFileQuery) As IAsyncOperation(Of IReadOnlyList(Of StorageFile))Parametri
- query
- CommonFileQuery
Uno dei valori di enumerazione che specifica come ordinare i file e determina se la query è superficiale o profonda.
Restituisce
Al termine di questo metodo, restituisce un elenco semplice di file, ordinato come specificato dalla query. L'elenco è di tipo IReadOnlyList<StorageFile>. Ogni file nell'elenco è rappresentato da un oggetto StorageFile .
Implementazioni
- Attributi
Eccezioni
Non si dispone dell'autorizzazione per accedere al contenuto della cartella corrente. Per altre informazioni, vedere Autorizzazioni di accesso ai file.
Vedi anche
- GetFilesAsync(CommonFileQuery, UInt32, UInt32)
- GetFilesAsync()
- Autorizzazioni di accesso ai file
- GetItemsAsync
Si applica a
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 query è diverso da CommonFileQuery.DefaultQuery. I file vengono ordinati in base al valore specificato dall'enumerazione CommonFileQuery .
public:
virtual IAsyncOperation<IVectorView<StorageFile ^> ^> ^ GetFilesAsync(CommonFileQuery query, unsigned int startIndex, unsigned int maxItemsToRetrieve) = GetFilesAsync;/// [Windows.Foundation.Metadata.Overload("GetFilesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFile>> GetFilesAsync(CommonFileQuery const& query, uint32_t const& startIndex, uint32_t const& maxItemsToRetrieve);[Windows.Foundation.Metadata.Overload("GetFilesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFile>> GetFilesAsync(CommonFileQuery query, uint startIndex, uint maxItemsToRetrieve);function getFilesAsync(query, startIndex, maxItemsToRetrieve)Public Function GetFilesAsync (query As CommonFileQuery, startIndex As UInteger, maxItemsToRetrieve As UInteger) As IAsyncOperation(Of IReadOnlyList(Of StorageFile))Parametri
- query
- CommonFileQuery
Uno dei valori di enumerazione che specifica come ordinare i file e determina se la query è superficiale o profonda.
- startIndex
-
UInt32
unsigned int
uint32_t
Indice in base zero del primo file nell'intervallo da recuperare.
- maxItemsToRetrieve
-
UInt32
unsigned int
uint32_t
Numero massimo di file da recuperare.
Restituisce
Al termine di questo metodo, restituisce un elenco semplice di file ordinati come specificato dalla query. L'elenco è di tipo IReadOnlyList<StorageFile>. Ogni file nell'elenco è rappresentato da un oggetto StorageFile .
Implementazioni
- Attributi
Eccezioni
Non si dispone dell'autorizzazione per accedere al contenuto della cartella corrente. Per altre informazioni, vedere Autorizzazioni di accesso ai file.