ImageProperties クラス

定義

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

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
属性
実装

Windows の要件

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

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

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

注意

別のアプリ (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>>)

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

適用対象

こちらもご覧ください