StorageFile.Properties 属性

定义

命名空间:

Windows.Storage

获取一个 对象，该对象提供对文件的内容相关属性的访问权限。

public:
 property StorageItemContentProperties ^ Properties { StorageItemContentProperties ^ get(); };

StorageItemContentProperties Properties();

public StorageItemContentProperties Properties { get; }

var storageItemContentProperties = storageFile.properties;

Public ReadOnly Property Properties As StorageItemContentProperties

属性值

StorageItemContentProperties

对象，该对象提供对文件的内容相关属性的访问权限。

实现

Properties

示例

此示例演示如何使用 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 获取包含指定属性的对象。

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

注解

注意

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

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