Provides access to the image-related properties of an item (like a file or folder).
The ImageProperties class has these types of members:
The ImageProperties class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.
|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.|
The ImageProperties class has these properties.
|Read/write||Gets or sets the manufacturer of the camera that took the photo.|
|Read/write||Gets or sets the model of the camera that took the photo.|
|Read/write||Gets or sets the date when the image was taken.|
|Read-only||Gets the height of the image.|
|Read-only||Gets the collection of keywords associated with the image.|
|Read-only||Gets the latitude coordinate where the photo was taken.|
|Read-only||Gets the longitude coordinate where the photo was taken.|
|Read-only||Gets the Exchangeable Image File (EXIF) orientation flag of the photo.|
|Read-only||Gets the names of people who are tagged in the photo.|
|Read/write||Gets or sets the rating associated with an image file.|
|Read/write||Gets or sets the title of the image.|
|Read-only||Gets the width of the image.|
You can access a ImageProperties object asynchronously using the getImagePropertiesAsync method from the Properties property of an item (like a file of folder), or synchronously using the ImageProperties property if it is available.
You can get a ImageProperties object using any of the following methods and properties:
- StorageItemContentProperties.getImagePropertiesAsync method, which can be accessed using the Properties property, if it is available.
- FileInformation.imageProperties property
- FolderInformation.imageProperties property
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.
After GetImagePropertiesAsync completes,
imageProperties gets a ImageProperties object.
In the example,
file contains a StorageFile that represents the file to retrieve properties for.
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|
- StorageItemContentProperties.getImagePropertiesAsync method
- Windows.Storage.BulkAccess.FileInformation.imageProperties property
- Windows.Storage.BulkAccess.FolderInformation.imageProperties property
- Windows.Storage.BulkAccess.IStorageItemInformation.ImageProperties property