StorageItemContentProperties Classe

Référence

Définition

Espace de noms:: Windows.Storage.FileProperties

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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

public ref class StorageItemContentProperties sealed

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

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

Public NotInheritable Class StorageItemContentProperties

Héritage: Object Platform::Object IInspectable StorageItemContentProperties

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 des propriétés de contenu ou des propriétés spécifiées à partir d’un fichier à l’aide de StorageFile.Properties.

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);

        // Specify more properties to retrieve
        readonly string dateAccessedProperty = "System.DateAccessed";
        readonly string fileOwnerProperty = "System.FileOwner";
        List<string> propertiesName = new List<string>();
        propertiesName.Add(dateAccessedProperty);
        propertiesName.Add(fileOwnerProperty);

        // Get the specified properties through StorageFile.Properties
        IDictionary<string, object> extraProperties = await file.Properties.RetrievePropertiesAsync(propertiesName);
        var propValue = extraProperties[dateAccessedProperty];
        if (propValue != null)
        {
            outputText.AppendLine("Date accessed: " + propValue);
        }
        propValue = extraProperties[fileOwnerProperty];
        if (propValue != null)
        {
            outputText.AppendLine("File owner: " + propValue);
        }
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

Une fois GetImagePropertiesAsync terminé, imageProperties obtient un objet ImageProperties . En outre, une fois RetrievePropertiesAsync terminé, extraProperties obtient un objet qui contient les propriétés spécifiées (la liste des propriétés prises en charge se trouve dans la page Propriétés principales).

Dans l’exemple, le fichier contient un StorageFile qui représente le fichier dont les propriétés doivent être récupérées.

Remarques

Vous pouvez obtenir un objet StorageItemContentProperties à l’aide de la propriété Properties disponible sur les objets suivants :

Notes

Les propriétés qui sont get 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 obtenir d’autres exemples de code sur l’accès aux propriétés, consultez l’exemple Accès aux fichiers.

Méthodes

GetDocumentPropertiesAsync()	Récupère les propriétés de document de l’élément (comme un fichier de dossier).
GetImagePropertiesAsync()	Récupère les propriétés d’image de l’élément (comme un fichier de dossier).
GetMusicPropertiesAsync()	Récupère les propriétés musicales de l’élément (comme un fichier de dossier).
GetVideoPropertiesAsync()	Récupère les propriétés vidéo de l’élément (comme un fichier de dossier).
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.

S’applique à

Voir aussi

Page des propriétés principales

Partager via