ImageProperties クラス

定義

名前空間:

Windows.Storage.FileProperties

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

public ref class ImageProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class ImageProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class ImageProperties

Public NotInheritable Class ImageProperties

継承

Object Platform::Object IInspectable ImageProperties

属性

ContractVersionAttribute

実装

IStorageItemExtraProperties

Windows の要件

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

例

この例では、 DateTaken や Rating などの画像プロパティなど、ファイルのプロパティを取得する方法を示します。

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);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

GetImagePropertiesAsync が完了したら、 imageProperties ImageProperties オブジェクトを取得します。

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

注釈

ImageProperties オブジェクトに非同期的にアクセスするには、アイテムの Properties プロパティ (フォルダーのファイルなど) から getImagePropertiesAsync メソッドを使用するか、ImageProperties プロパティが使用可能な場合は同期的に使用します。 ImageProperties オブジェクトは、次のいずれかのメソッドとプロパティを使用して取得できます。

• StorageItemContentProperties.getImagePropertiesAsync メソッド。 Properties プロパティ (使用可能な場合) を使用してアクセスできます。
• FileInformation.imageProperties プロパティ
• FolderInformation.imageProperties プロパティ

注意

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

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

プロパティ

CameraManufacturer	写真を撮影したカメラの製造元を取得または設定します。
CameraModel	写真を撮影したカメラのモデルを取得または設定します。
DateTaken	イメージが取得された日付を取得または設定します。
Height	イメージの高さを取得します。
Keywords	イメージに関連付けられているキーワードのコレクションを取得します。
Latitude	写真が撮影された緯度座標を取得します。
Longitude	写真が撮影された経度座標を取得します。
Orientation	写真の Exchangeable Image File (EXIF) 方向フラグを取得します。
PeopleNames	写真にタグ付けされているユーザーの名前を取得します。
Rating	イメージ ファイルに関連付けられている評価を取得または設定します。
Title	イメージのタイトルを取得または設定します。
Width	イメージの幅を取得します。

メソッド

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

こちらもご覧ください

• GetImagePropertiesAsync()
• ImageProperties
• ImageProperties
• ImageProperties