BasicProperties class

Applies to Windows and Windows Phone

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).

Syntax


public sealed class BasicProperties : IStorageItemExtraProperties

Attributes

[Muse()]
[Version(0x06020000)]

Members

The BasicProperties class has these types of members:

Methods

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

MethodDescription
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.

 

Properties

The BasicProperties class has these properties.

PropertyAccess typeDescription

DateModified

Read-onlyGets the timestamp of the last time the file was modified.

ItemDate

Read-onlyGets the most relevant date for the item.

Size

Read-onlyGets the size of the file.

 

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:

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.

Requirements

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

Namespace

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

Metadata

Windows.winmd

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

 

 

Show:
© 2014 Microsoft