ImageProperties 类

定义

命名空间:

Windows.Storage.FileProperties

提供对项 (（如文件或文件夹) ）与图像相关的属性的访问。

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

继承

Object Platform::Object IInspectable ImageProperties

属性

ContractVersionAttribute

实现

IStorageItemExtraProperties

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>>)	保存与项关联的指定属性和值。

另请参阅

• GetImagePropertiesAsync()
• ImageProperties
• ImageProperties
• ImageProperties