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。

如需存取屬性的詳細資訊程式碼範例，請參閱 檔案存取範例。