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 ，代表要擷取屬性的檔案。

備註

您可以使用 getImagePropertiesAsync 方法，從專案的 Properties 屬性非同步存取 ImageProperties 物件， (像是資料夾) 的檔案，或者如果有的話，請以同步方式使用 ImageProperties 屬性。 您可以使用下列任何方法和屬性來取得 ImageProperties 物件：

• StorageItemContentProperties.getImagePropertiesAsync 方法，如果可用，可以使用 Properties 屬性來存取此方法。
• FileInformation.imageProperties 屬性
• FolderInformation.imageProperties 屬性

注意

使用其他應用程式所定義的屬性處理常式取得或設定的屬性， (例如 Microsoft Word) 可能無法存取。 相反地，您可以使用系統索引所支援的檔案查詢來嘗試取得這些屬性。 如需詳細資訊，請參閱 QueryOptions。

如需有關存取屬性的詳細資訊程式碼範例，請參閱 檔案存取範例。

屬性

CameraManufacturer	取得或設定拍攝相片之相機的製造商。
CameraModel	取得或設定拍攝相片之相機的模型。
DateTaken	取得或設定擷取影像的日期。
Height	取得影像的高度。
Keywords	取得與影像相關聯的關鍵字集合。
Latitude	取得拍攝相片的緯度座標。
Longitude	取得拍攝相片的經度座標。
Orientation	取得相片的可交換影像檔 (EXIF) 方向旗標。
PeopleNames	取得在相片中標記的人員名稱。
Rating	取得或設定與影像檔相關聯的評等。
Title	取得或設定影像的標題。
Width	取得影像的寬度。

方法

RetrievePropertiesAsync(IIterable<String>)	擷取與專案相關聯的指定屬性。
SavePropertiesAsync()	儲存與專案相關聯的所有屬性。
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	儲存與專案相關聯的指定屬性和值。

另請參閱

• GetImagePropertiesAsync()
• ImageProperties
• ImageProperties
• ImageProperties