Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
MSDN Library
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

StorageItemContentProperties class

Provides access to the content-related properties of an item (like a file or folder).


var storageItemContentProperties = storageFile.properties;


The StorageItemContentProperties class has these types of members:


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

GetDocumentPropertiesAsync Retrieves the document properties of the item (like a file of folder).
GetImagePropertiesAsync Retrieves the image properties of the item (like a file of folder).
GetMusicPropertiesAsync Retrieves the music properties of the item (like a file of folder).
GetVideoPropertiesAsync Retrieves the video properties of the item (like a file of folder).
RetrievePropertiesAsync Retrieves the specified properties associated with the item.
SavePropertiesAsync() Saves all properties associated with the item.
SavePropertiesAsync(IIterable(IKeyValuePair)) Saves the specified properties and values associated with the item.



You can get a StorageItemContentProperties object using the Properties property that is available on the following objects:

Note  Properties that are get or set using a property handler that is defined by another app (like Microsoft Word) may not be accessible. Instead, you can try to get these properties using a file query that is backed by the system index. For more information, see QueryOptions.

For more code samples about accessing properties, see the File access sample.


This example demonstrates how to retrieve content properties or specified properties from a file using StorageFile.Properties.

var file = SdkSample.sampleFile;
if (file !== null) {
    var outputDiv = document.getElementById("output");

    // Get image properties
    file.properties.getImagePropertiesAsync().then(function (imageProperties) {
        outputDiv.innerHTML += "Date taken: " + imageProperties.dateTaken + "<br />";
        outputDiv.innerHTML += "Rating: " + imageProperties.rating + "<br />";

        // Specify more properties to retrieve
        var dateAccessedProperty = "System.DateAccessed";
        var fileOwnerProperty    = "System.FileOwner";

        // Get the specified properties through storageFile.properties
        return file.properties.retrievePropertiesAsync([fileOwnerProperty, dateAccessedProperty]);
    }).done(function (extraProperties) {
        var propValue = extraProperties[dateAccessedProperty];
        if (propValue !== null) {
            outputDiv.innerHTML += "Date accessed: " + propValue + "<br />";
        propValue = extraProperties[fileOwnerProperty];
        if (propValue !== null) {
            outputDiv.innerHTML += "File owner: " + propValue;
    // Handle errors with an error function
	   function (error) {
	       // Handle errors encountered while retrieving properties

After GetImagePropertiesAsync completes, imageProperties gets a ImageProperties object. Additionally, after RetrievePropertiesAsync completes, extraProperties gets an object that contains the specified properties.

In the example, file contains a StorageFile that represents the file to retrieve properties for.

Requirements (Windows 10 device family)

Device family


API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0


Windows::Storage::FileProperties [C++]



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

Minimum supported client

Windows 8 [Windows Store apps only]

Minimum supported server

Windows Server 2012 [Windows Store apps only]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]


Windows::Storage::FileProperties [C++]





See also

Windows.Storage.StorageFile.properties property
Windows.Storage.StorageFolder.properties property
Windows.Storage.BulkAccess.fileInformation.properties property
Windows.Storage.BulkAccess.folderInformation.properties property



© 2015 Microsoft