ImageProperties Classe

Définition

Espace de noms:

Windows.Storage.FileProperties

Fournit l’accès aux propriétés liées à l’image d’un élément (comme un fichier ou un dossier).

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

Héritage

Object Platform::Object IInspectable ImageProperties

Attributs

ContractVersionAttribute

Implémente

IStorageItemExtraProperties

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple montre comment récupérer les propriétés d’un fichier, y compris les propriétés d’image telles que DateTaken et 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
}

Une fois GetImagePropertiesAsync terminé, imageProperties obtient un objet ImageProperties.

Dans l’exemple, file contient un StorageFile qui représente le fichier pour lequel récupérer des propriétés.

Remarques

Vous pouvez accéder à un objet ImageProperties de manière asynchrone à l’aide de la méthode getImagePropertiesAsync à partir de la propriété Properties d’un élément (comme un fichier de dossier) ou de manière synchrone à l’aide de la propriété ImageProperties si elle est disponible. Vous pouvez obtenir un objet ImageProperties à l’aide de l’une des méthodes et propriétés suivantes :

• Méthode StorageItemContentProperties.getImagePropertiesAsync , accessible à l’aide de la propriété Properties , si elle est disponible.
• Propriété FileInformation.imageProperties
• Propriété FolderInformation.imageProperties

Notes

Les propriétés qui sont obtenir ou définies à l’aide d’un gestionnaire de propriétés défini par une autre application (comme Microsoft Word) peuvent ne pas être accessibles. Au lieu de cela, vous pouvez essayer d’obtenir ces propriétés à l’aide d’une requête de fichier qui est sauvegardée par l’index système. Pour plus d’informations, consultez QueryOptions.

Pour plus d’exemples de code sur l’accès aux propriétés, consultez l’exemple Accès aux fichiers.

Propriétés

CameraManufacturer	Obtient ou définit le fabricant de l’appareil photo qui a pris la photo.
CameraModel	Obtient ou définit le modèle de l’appareil photo qui a pris la photo.
DateTaken	Obtient ou définit la date à laquelle l’image a été prise.
Height	Obtient la hauteur de l’image.
Keywords	Obtient la collection de mots clés associés à l’image.
Latitude	Obtient la coordonnée de latitude où la photo a été prise.
Longitude	Obtient la coordonnée de longitude où la photo a été prise.
Orientation	Obtient l’indicateur d’orientation EXIF (Exchangeable Image File) de la photo.
PeopleNames	Obtient les noms des personnes étiquetées dans la photo.
Rating	Obtient ou définit l’évaluation associée à un fichier image.
Title	Obtient ou définit le titre de l’image.
Width	Obtient la largeur de l’image.

Méthodes

RetrievePropertiesAsync(IIterable<String>)	Récupère les propriétés spécifiées associées à l’élément.
SavePropertiesAsync()	Enregistre toutes les propriétés associées à l’élément.
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	Enregistre les propriétés et valeurs spécifiées associées à l’élément.

Voir aussi

• GetImagePropertiesAsync()
• ImageProperties
• ImageProperties
• ImageProperties