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 引進)

範例

檔案存取範例示範如何擷取檔案的屬性，包括Size和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 物件：

• storageFile.getBasicPropertiesAsync 方法
• storageFolder.getBasicPropertiesAsync 方法
• FileInformation.basicProperties 屬性
• FolderInformation.basicProperties 屬性

屬性

DateModified	取得上次修改檔案時的時間戳記。
ItemDate	取得專案最相關的日期。
Size	取得以位元組為單位的檔案大小。

方法

RetrievePropertiesAsync(IIterable<String>)	擷取與專案相關聯的指定屬性。
SavePropertiesAsync()	儲存與專案相關聯的所有屬性。
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	儲存與專案相關聯的指定屬性和值。

另請參閱

• IStorageItemExtraProperties
• GetBasicPropertiesAsync()
• GetBasicPropertiesAsync()
• GetBasicPropertiesAsync()
• BasicProperties
• BasicProperties
• BasicProperties