エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

StorageItemContentProperties Class

項目 (ファイルやフォルダーなど) のコンテンツ関連プロパティにアクセスできるようにします。

構文


var storageItemContentProperties = storageFile.properties;

属性

[Version(0x06020000)]

メンバー

StorageItemContentPropertiesクラス には次の種類のメンバーがあります。

メソッド

The StorageItemContentProperties クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
GetDocumentPropertiesAsync Retrieves the document properties of the item (like a file of folder).
GetImagePropertiesAsync Retrieves the image properties of the item (like a file of folder).
GetMusicPropertiesAsync Retrieves the music properties of the item (like a file of folder).
GetVideoPropertiesAsync Retrieves the video properties of the item (like a file of folder).
RetrievePropertiesAsync Retrieves the specified properties associated with the item.
SavePropertiesAsync() Saves all properties associated with the item.
SavePropertiesAsync(IIterable(IKeyValuePair)) Saves the specified properties and values associated with the item.

 

解説

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

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

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

Windows Phone 8

この API は実装されていません。呼び出された場合は、例外をスローします。「Windows Phone ランタイム API」を参照してください。

この例では、StorageFile.Properties を使用してファイルからコンテンツ プロパティまたは指定したプロパティを取得する方法を示しています。



var file = SdkSample.sampleFile;
if (file !== null) {
    var outputDiv = document.getElementById("output");

    // Get image properties
    file.properties.getImagePropertiesAsync().then(function (imageProperties) {
        outputDiv.innerHTML += "Date taken: " + imageProperties.dateTaken + "<br />";
        outputDiv.innerHTML += "Rating: " + imageProperties.rating + "<br />";

        // Specify more properties to retrieve
        var dateAccessedProperty = "System.DateAccessed";
        var fileOwnerProperty    = "System.FileOwner";

        // Get the specified properties through storageFile.properties
        return file.properties.retrievePropertiesAsync([fileOwnerProperty, dateAccessedProperty]);
    }).done(function (extraProperties) {
        var propValue = extraProperties[dateAccessedProperty];
        if (propValue !== null) {
            outputDiv.innerHTML += "Date accessed: " + propValue + "<br />";
        }
        propValue = extraProperties[fileOwnerProperty];
        if (propValue !== null) {
            outputDiv.innerHTML += "File owner: " + propValue;
        }
    },
    // Handle errors with an error function
	   function (error) {
	       // Handle errors encountered while retrieving properties
    });
}

GetImagePropertiesAsync が完了すると、imagePropertiesImageProperties オブジェクトを取得します。また、RetrievePropertiesAsync が完了すると、extraProperties は指定されたプロパティを含むオブジェクトを取得します。

この例では、file は、プロパティを取得するファイルを表す StorageFile を格納しています。

要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

最小限サポートされる携帯電話

Windows Phone 8 [実装されていません。"解説" を参照してください]

名前空間

Windows.Storage.FileProperties
Windows::Storage::FileProperties [C++]

メタデータ

Windows.winmd

参照

Windows.Storage.StorageFile.properties property
Windows.Storage.StorageFolder.properties property
Windows.Storage.BulkAccess.fileInformation.properties property
Windows.Storage.BulkAccess.folderInformation.properties property

 

 

表示:
© 2015 Microsoft