StorageFile.Properties Propriété

Définition

Espace de noms:

Windows.Storage

Obtient un objet qui fournit l’accès aux propriétés liées au contenu du fichier.

public:
 property StorageItemContentProperties ^ Properties { StorageItemContentProperties ^ get(); };

StorageItemContentProperties Properties();

public StorageItemContentProperties Properties { get; }

var storageItemContentProperties = storageFile.properties;

Public ReadOnly Property Properties As StorageItemContentProperties

Valeur de propriété

StorageItemContentProperties

Objet qui fournit l’accès aux propriétés liées au contenu du fichier.

Implémente

Properties

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.

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

Remarques

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.