StorageFile.Properties Propriété
Définition
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.
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é
Objet qui fournit l’accès aux propriétés liées au contenu du fichier.
Implémente
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.