ImageProperties 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供对项 ((如文件或文件夹) )与图像相关的属性的访问。
public ref class ImageProperties sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class ImageProperties final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class ImageProperties
Public NotInheritable Class ImageProperties
- 继承
- 属性
- 实现
Windows 要求
设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
示例
此示例演示如何检索文件的属性,包括 DateTaken 和 Rating 等图像属性。
try
{
StorageFile file = rootPage.sampleFile;
if (file != null)
{
StringBuilder outputText = new StringBuilder();
// Get image properties
ImageProperties imageProperties = await file.Properties.GetImagePropertiesAsync();
outputText.AppendLine("Date taken: " + imageProperties.DateTaken);
outputText.AppendLine("Rating: " + imageProperties.Rating);
}
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
// For example, handle a file not found error
}
GetImagePropertiesAsync 完成后,imageProperties
获取 ImageProperties 对象。
在此示例中, file
包含一个 StorageFile ,表示要检索其属性的文件。
注解
可以使用 getImagePropertiesAsync 方法异步访问 ImageProperties 对象,方法从项目 (的 Properties 属性(如文件夹) 的文件)访问 ImageProperties 对象,或者同步使用 ImageProperties 属性(如果可用)。 可以使用以下任一方法和属性获取 ImageProperties 对象:
- StorageItemContentProperties.getImagePropertiesAsync 方法,如果可用,可以使用 Properties 属性进行访问。
- FileInformation.imageProperties 属性
- FolderInformation.imageProperties 属性
注意
使用由其他应用(如 Microsoft (Word) )定义的属性处理程序获取或设置的属性可能无法访问。 相反,可以尝试使用由系统索引支持的文件查询来获取这些属性。 有关详细信息,请参阅 QueryOptions。
有关访问属性的更多代码示例,请参阅 文件访问示例。
属性
CameraManufacturer |
获取或设置拍摄照片的相机的制造商。 |
CameraModel |
获取或设置拍摄照片的相机的型号。 |
DateTaken |
获取或设置拍摄图像的日期。 |
Height |
获取图像的高度。 |
Keywords |
获取与图像关联的关键字的集合。 |
Latitude |
获取照片拍摄位置的纬度坐标。 |
Longitude |
获取照片拍摄位置的经度坐标。 |
Orientation |
获取照片 (EXIF) 方向标志的可交换图像文件。 |
PeopleNames |
获取在照片中标记的人员的姓名。 |
Rating |
获取或设置与图像文件关联的分级。 |
Title |
获取或设置图像的标题。 |
Width |
获取图像的宽度。 |
方法
RetrievePropertiesAsync(IIterable<String>) |
检索与项关联的指定属性。 |
SavePropertiesAsync() |
保存与项关联的所有属性。 |
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
保存与项关联的指定属性和值。 |