StorageFile class

Represents a file. Provides information about the file and its content, and ways to manipulate them.

Syntax

public sealed class StorageFile : Object,
    IStorageFile,
    IStorageItem,
    IRandomAccessStreamReference,
    IInputStreamReference,
    IStorageItemProperties

Attributes

MarshalingBehaviorAttribute(Agile)

MuseAttribute()

StaticAttribute(Windows.Storage.IStorageFileStatics, NTDDI_WIN8)

VersionAttribute(NTDDI_WIN8)

Members

The StorageFile class has these types of members:

• Methods
• Properties

Methods

The StorageFile class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Properties

The StorageFile class has these properties.

Remarks

Typically, you access StorageFile objects as the result of asynchronous method and/or function calls. For example, both of the static methods GetFileFromPathAsync and GetFileFromApplicationUriAsync return a StorageFile that represents the specified file.

Additionally, whenever you call a file picker to let the user pick a file (or files) the file picker will return the file as a StorageFile.

Note  StorageFile objects can't represent files that are ".lnk", ".url", or ".wsh" file types.

Examples

This example shows you how to call a file picker, using FileOpenPicker.PickSingleFileAsync to capture and process a file that the users picks.

StorageFile file = await openPicker.PickSingleFileAsync();
// Process picked file
if (file != null)
{
    // Store file for future access
    fileToken = Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);
}
else
{
    // The user didn't pick a file
}

After PickSingleFileAsync completes, file gets the picked file as a StorageFile.

In the example, openPicker contains a FileOpenPicker object. To learn more about using file pickers see FileOpenPicker and Quickstart: Accessing files with file pickers.

Additionally, fileToken gets an identifier that you can use to retrieve the file from the FutureAccessList. To learn more about storing files and folders so you can access them again later, see FutureAccessList, MostRecentlyUsedList and How to track recently used files and folders.

Requirements

See also

StorageFolder

Build date: 2/25/2013