StorageFolder.GetFilesAsync() | getFilesAsync() method

Applies to Windows and Windows Phone

Gets the files in the current folder.

Syntax


storageFolder.getFilesAsync().done( /* Your success and error handlers */ );

Parameters

This method has no parameters.

Return value

Type: IAsyncOperation<IVectorView>

When this method completes successfully, it returns a list of the files in the current folder. The list is of type IReadOnlyList<StorageFile>. Each file in the list is represented by a StorageFile object.

Exceptions

ExceptionCondition
System.UnauthorizedAccessException

You don't have permission to access the contents of the current folder.

Remarks

This query is a shallow query that returns only files in the current folder. For a list of methods that identifies shallow queries and deep queries, see the Remarks in the topic GetFilesAsync.

To specify additional query options, call the CreateFileQueryWithOptions method.

To get items that are files or folders, call the GetItemsAsync method.

Examples

The following example shows how to get the files in the current folder by calling the GetFilesAsync() method.


using Windows.Storage;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to Output window.
...
            // Get the app's installation folder.
            StorageFolder appFolder =
                Windows.ApplicationModel.Package.Current.InstalledLocation;

            // Get the files in the current folder.
            IReadOnlyList <StorageFile> filesInFolder =
                     await appFolder.GetFilesAsync();

            // Iterate over the results and print the list of files
            // to the Visual Studio Output window.
            foreach (StorageFile file in filesInFolder)
                Debug.WriteLine(file.Name + ", " + file.DateCreated);


Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8

Namespace

Windows.Storage
Windows::Storage [C++]

Metadata

Windows.winmd

See also

StorageFolder
GetFilesAsync(CommonFileQuery, UInt32, UInt32)
GetFilesAsync(CommonFileQuery)
GetItemsAsync

 

 

Show:
© 2014 Microsoft