StorageItemContentProperties クラス

定義

アイテムのコンテンツ関連のプロパティ (ファイルやフォルダーなど) へのアクセスを提供します。

public ref class StorageItemContentProperties sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemContentProperties final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemContentProperties
Public NotInheritable Class StorageItemContentProperties
継承
Object Platform::Object IInspectable StorageItemContentProperties
属性
実装

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

この例では、 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 が完了すると、imagePropertiesImageProperties オブジェクトを取得します。 さらに、 RetrievePropertiesAsync が完了すると、 extraProperties は指定されたプロパティを含むオブジェクトを取得します (サポートされているプロパティの一覧は、[ コア プロパティ] ページにあります)。

この例では、 file には、プロパティを取得するファイルを表す StorageFile が含まれています。

注釈

StorageItemContentProperties オブジェクトは、次のオブジェクトで使用できる Properties プロパティを使用して取得できます。

Note

別のアプリ (Microsoft Word など) によって定義されたプロパティ ハンドラーを使用して取得または設定されたプロパティにアクセスできない場合があります。 代わりに、システム インデックスによってサポートされるファイル クエリを使用して、これらのプロパティを取得できます。 詳細については、「 QueryOptions」を参照してください。

プロパティへのアクセスに関するコード サンプルの詳細については、「 ファイル アクセスのサンプル」を参照してください。

メソッド

GetDocumentPropertiesAsync()

アイテムのドキュメント プロパティ (フォルダーのファイルなど) を取得します。

GetImagePropertiesAsync()

アイテムのイメージ プロパティ (フォルダーのファイルなど) を取得します。

GetMusicPropertiesAsync()

アイテムの music プロパティ (フォルダーのファイルなど) を取得します。

GetVideoPropertiesAsync()

アイテムのビデオ プロパティ (フォルダーのファイルなど) を取得します。

RetrievePropertiesAsync(IIterable<String>)

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

SavePropertiesAsync()

アイテムに関連付けられているすべてのプロパティを保存します。

SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

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

適用対象

こちらもご覧ください