StorageItemContentProperties 类

定义

命名空间:

Windows.Storage.FileProperties

提供对项的内容相关属性的访问， (如文件或文件夹) 。

public ref class StorageItemContentProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemContentProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemContentProperties

Public NotInheritable Class StorageItemContentProperties

继承

Object Platform::Object IInspectable StorageItemContentProperties

属性

ContractVersionAttribute

实现

IStorageItemExtraProperties

Windows 要求

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

示例

此示例演示如何使用 StorageFile.Properties 从文件检索内容属性或指定属性。

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

        // 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
}

GetImagePropertiesAsync 完成后，imageProperties 将获取 ImageProperties 对象。 此外， 在 RetrievePropertiesAsync 完成后， extraProperties 将获取一个对象，该对象包含指定属性 (可在 核心属性页) 中找到支持的属性列表。

在此示例中， 文件 包含一个 StorageFile ，表示要检索其属性的文件。

注解

可以使用在以下对象上可用的 Properties 属性获取 StorageItemContentProperties 对象：

• StorageFile.Properties 属性
• StorageFolder.Properties 属性
• FileInformation.Properties 属性
• FolderInformation.Properties 属性

注意

使用由其他应用（如 Microsoft (Word) ）定义的属性处理程序获取或设置的属性可能无法访问。 相反，可以尝试使用由系统索引支持的文件查询来获取这些属性。 有关详细信息，请参阅 QueryOptions。

有关访问属性的更多代码示例，请参阅 文件访问示例。

方法

GetDocumentPropertiesAsync()	检索项 (的文档属性，例如文件夹) 的文件。
GetImagePropertiesAsync()	检索项 (的图像属性，例如文件夹) 的文件。
GetMusicPropertiesAsync()	检索项目 (的音乐属性，例如文件夹) 的文件。
GetVideoPropertiesAsync()	检索项 (的视频属性，例如文件夹) 的文件。
RetrievePropertiesAsync(IIterable<String>)	检索与项关联的指定属性。
SavePropertiesAsync()	保存与项关联的所有属性。
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	保存与项关联的指定属性和值。

另请参阅

• “核心属性”页