ImageProperties 类

定义

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

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
属性
实现

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

此示例演示如何检索文件的属性,包括 DateTakenRating 等图像属性。

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 对象:

注意

使用由其他应用(如 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>>)

保存与项关联的指定属性和值。

适用于

另请参阅