BasicProperties 类

  • 参考

定义

命名空间:
Windows.Storage.FileProperties
编辑

提供对项 (（如文件或文件夹) ）的基本属性（如项目的大小或上次修改日期）的访问。

public ref class BasicProperties sealed : IStorageItemExtraProperties
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class BasicProperties final : IStorageItemExtraProperties
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class BasicProperties : IStorageItemExtraProperties
Public NotInheritable Class BasicProperties
Implements IStorageItemExtraProperties
继承
Object Platform::Object IInspectable BasicProperties
属性
ContractVersionAttribute
实现
IStorageItemExtraProperties

Windows 要求

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

示例

文件访问示例演示如何检索文件的属性，包括大小和 DateModified 等基本属性。

try
{
    StorageFile file = rootPage.sampleFile;
    if (file != null)
    {
        StringBuilder outputText = new StringBuilder();

        // Get basic properties
        BasicProperties basicProperties = await file.GetBasicPropertiesAsync();
        outputText.AppendLine("File size: " + basicProperties.Size + " bytes");
        outputText.AppendLine("Date modified: " + basicProperties.DateModified);

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

GetBasicPropertiesAsync 完成后，basicProperties获取 BasicProperties 对象。

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

注解

可以使用项的 GetBasicPropertiesAsync 方法（如文件夹 () 文件）异步访问 BasicProperties 对象，也可以使用 BasicProperties 属性（如果可用）进行同步访问。

可以使用以下任一方法和属性获取 BasicProperties 对象：

属性

DateModified

获取上次修改文件的时间戳。
ItemDate

获取项最相关的日期。
Size

获取文件的大小（以字节为单位）。

方法

RetrievePropertiesAsync(IIterable<String>)

检索与项关联的指定属性。
SavePropertiesAsync()

保存与项关联的所有属性。
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

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

适用于

另请参阅