此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

StorageItemContentProperties Class

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

语法


var storageItemContentProperties = storageFile.properties;

特性

[Version(0x06020000)]

成员

StorageItemContentProperties类 具有这些类型的成员:

方法

The StorageItemContentProperties 类 具有这些方法。 对于 C#、Visual Basic 和 C++,它还继承方法于Object 类.

方法说明
GetDocumentPropertiesAsync Retrieves the document properties of the item (like a file of folder).
GetImagePropertiesAsync Retrieves the image properties of the item (like a file of folder).
GetMusicPropertiesAsync Retrieves the music properties of the item (like a file of folder).
GetVideoPropertiesAsync Retrieves the video properties of the item (like a file of folder).
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.

 

备注

您可以使用在下列对象中有效的 Properties 属性获取 StorageItemContentProperties 对象:

注意  使用由另一个应用程序定义的属性处理程序(如 Microsoft Word)获取或设置属性可能不可访问。相反,您可以使用由系统索引返回的文件查询尝试获取这些属性。 有关更多信息,请参见 QueryOptions

有关访问属性的更多代码示例,请参见文件访问示例

Windows Phone 8

此 API 不实现,但是调用时会引发异常。请参见 Windows Phone 运行时 API

示例

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



var file = SdkSample.sampleFile;
if (file !== null) {
    var outputDiv = document.getElementById("output");

    // Get image properties
    file.properties.getImagePropertiesAsync().then(function (imageProperties) {
        outputDiv.innerHTML += "Date taken: " + imageProperties.dateTaken + "<br />";
        outputDiv.innerHTML += "Rating: " + imageProperties.rating + "<br />";

        // Specify more properties to retrieve
        var dateAccessedProperty = "System.DateAccessed";
        var fileOwnerProperty    = "System.FileOwner";

        // Get the specified properties through storageFile.properties
        return file.properties.retrievePropertiesAsync([fileOwnerProperty, dateAccessedProperty]);
    }).done(function (extraProperties) {
        var propValue = extraProperties[dateAccessedProperty];
        if (propValue !== null) {
            outputDiv.innerHTML += "Date accessed: " + propValue + "<br />";
        }
        propValue = extraProperties[fileOwnerProperty];
        if (propValue !== null) {
            outputDiv.innerHTML += "File owner: " + propValue;
        }
    },
    // Handle errors with an error function
	   function (error) {
	       // Handle errors encountered while retrieving properties
    });
}

GetImagePropertiesAsync 完成后,imageProperties 将获取 ImageProperties 对象。此外,RetrievePropertiesAsync 完成后,extraProperties 会获取包含指定属性的对象。

在示例中,file 包含在表示文件以检索属性的 StorageFile

要求

最低支持客户端

Windows 8 [仅 Windows 应用商店应用程序]

最低支持服务器

Windows Server 2012 [仅 Windows 应用商店应用程序]

最低支持电话

Windows Phone 8 [未实现,请参见备注]

命名空间

Windows.Storage.FileProperties
Windows::Storage::FileProperties [C++]

元数据

Windows.winmd

另请参见

Windows.Storage.StorageFile.properties property
Windows.Storage.StorageFolder.properties property
Windows.Storage.BulkAccess.fileInformation.properties property
Windows.Storage.BulkAccess.folderInformation.properties property

 

 

显示:
© 2015 Microsoft