Skip to main content
StorageFileQueryResult.GetFilesAsync(UInt32, UInt32) | getFilesAsync(UInt32, UInt32) method

Retrieves a list of files in a specified range.

Syntax


storageFileQueryResult.getFilesAsync(startIndex, maxNumberOfItems).done( /* Your success and error handlers */ );

public IAsyncOperation<IReadOnlyList> GetFilesAsync(
  uint startIndex, 
  uint maxNumberOfItems
)

Public Function GetFilesAsync(
  startIndex As UInteger,  
  maxNumberOfItems As UInteger 
) As IAsyncOperation(Of IReadOnlyList)

public:
IAsyncOperation<IVectorView>^ GetFilesAsync(
  unsigned int startIndex, 
  unsigned int maxNumberOfItems
)

Parameters

startIndex

Type: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

The zero-based index of the first file to retrieve. This parameter is 0 by default.

maxNumberOfItems

Type: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

The maximum number of files to retrieve. Use -1 to retrieve all files. If the range contains fewer files than the max number, all files in the range are returned.

Return value

Type: IAsyncOperation<IVectorView>

When this method completes successfully, it returns a list (type IVectorView) of files that are represented by storageFile objects.

Remarks

Use this overload to improve system performance by presenting a virtualized view of the query results that includes only the necessary subset of files. For example, if your app displays many files in a gallery you could use this range to retrieve only the files that are currently visible to the user.

Requirements (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

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

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows 10 Mobile

Namespace

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

Metadata

Windows.winmd

See also

storageFileQueryResult class
storageFileQueryResult.getFilesAsync() method
Windows.Foundation.Collections.IVectorView interface