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

Applies to Windows only

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

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported

Namespace

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

Metadata

Windows.winmd

See also

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