Windows.Storage.FileProperties.BasicProperties

-description

Provides access to the basic properties, like the size of the item or the date the item was last modified, of the item (like a file or folder).

-remarks

You can access a BasicProperties object asynchronously using the GetBasicPropertiesAsync method of an item (like a file of folder), or synchronously using the BasicProperties property if it is available.

You can get a BasicProperties object using any of the following methods and properties:

• storageFile.getBasicPropertiesAsync method
• storageFolder.getBasicPropertiesAsync method
• FileInformation.basicProperties property
• FolderInformation.basicProperties property

-examples

The File access sample demonstrates how to retrieve properties of a file, including basic properties like Size and DateModified.

try
{
    StorageFile file = rootPage.sampleFile;
    if (file != null)
    {
        StringBuilder outputText = new StringBuilder();

        // Get basic properties
        BasicProperties basicProperties = await file.GetBasicPropertiesAsync();
        outputText.AppendLine("File size: " + basicProperties.Size + " bytes");
        outputText.AppendLine("Date modified: " + basicProperties.DateModified);

        // Specify more properties to retrieve
        readonly string dateAccessedProperty = "System.DateAccessed";
        readonly string fileOwnerProperty = "System.FileOwner";
        List<string> propertiesName = new List<string>();
        propertiesName.Add(dateAccessedProperty);
        propertiesName.Add(fileOwnerProperty);

        // Get the specified properties through StorageFile.Properties
        IDictionary<string, object> extraProperties = await file.Properties.RetrievePropertiesAsync(propertiesName);
        var propValue = extraProperties[dateAccessedProperty];
        if (propValue != null)
        {
            outputText.AppendLine("Date accessed: " + propValue);
        }
        propValue = extraProperties[fileOwnerProperty];
        if (propValue != null)
        {
            outputText.AppendLine("File owner: " + propValue);
        }
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

After GetBasicPropertiesAsync completes, basicProperties gets a BasicProperties object.

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

-see-also

IStorageItemExtraProperties, Windows.Storage.StorageFile.getBasicPropertiesAsync method, Windows.Storage.StorageFolder.getBasicPropertiesAsync method, Windows.Storage.IStorageItem.GetBasicPropertiesAsync method, Windows.Storage.BulkAccess.FileInformation.basicProperties property, Windows.Storage.BulkAccess.FolderInformation.BasicProperties property, Windows.Storage.BulkAccess.IStorageItemInformation.BasicProperties property