StorageItemContentProperties クラス

リファレンス

定義

名前空間:: Windows.Storage.FileProperties

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

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

属性: ContractVersionAttribute

実装: IStorageItemExtraProperties

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

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

注釈

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

StorageFile.Properties プロパティ
StorageFolder.Properties プロパティ
FileInformation.Properties プロパティ
FolderInformation.Properties プロパティ

Note

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

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

メソッド

GetDocumentPropertiesAsync()	アイテムのドキュメントプロパティ (フォルダーのファイルなど) を取得します。
GetImagePropertiesAsync()	アイテムのイメージプロパティ (フォルダーのファイルなど) を取得します。
GetMusicPropertiesAsync()	アイテムの music プロパティ (フォルダーのファイルなど) を取得します。
GetVideoPropertiesAsync()	アイテムのビデオプロパティ (フォルダーのファイルなど) を取得します。
RetrievePropertiesAsync(IIterable<String>)	アイテムに関連付けられている指定したプロパティを取得します。
SavePropertiesAsync()	アイテムに関連付けられているすべてのプロパティを保存します。
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	アイテムに関連付けられている指定したプロパティと値を保存します。

適用対象

こちらもご覧ください

コアプロパティページ