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 が含まれています。

注釈

BasicProperties オブジェクトには、アイテムの GetBasicPropertiesAsync メソッド (フォルダーのファイルなど) を使用して非同期的にアクセスすることも、使用可能な場合は BasicProperties プロパティを使用して同期的にアクセスすることもできます。

BasicProperties オブジェクトは、次のいずれかのメソッドとプロパティを使用して取得できます。

プロパティ

DateModified

ファイルが最後に変更された時刻のタイムスタンプを取得します。
ItemDate

アイテムに最も関連する日付を取得します。
Size

ファイルのサイズをバイト単位で取得します。

メソッド

RetrievePropertiesAsync(IIterable<String>)

アイテムに関連付けられている指定したプロパティを取得します。
SavePropertiesAsync()

アイテムに関連付けられているすべてのプロパティを保存します。
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

アイテムに関連付けられている指定したプロパティと値を保存します。

適用対象

こちらもご覧ください