BasicProperties 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 de base, comme la taille de l’élément ou la date de la dernière modification de l’élément (comme un fichier ou un dossier).

public ref class BasicProperties sealed : IStorageItemExtraProperties

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class BasicProperties final : IStorageItemExtraProperties

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

Public NotInheritable Class BasicProperties
Implements IStorageItemExtraProperties

Héritage: Object Platform::Object IInspectable BasicProperties

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

L’exemple d’accès aux fichiers montre comment récupérer les propriétés d’un fichier, notamment les propriétés de base telles que Size et DateModified.

try
{
    StorageFile file = rootPage.sampleFile;
    if (file != null)
    {
        StringBuilder outputText = new StringBuilder();

        // Get basic properties
        BasicProperties basicProperties = await file.GetBasicPropertiesAsync();
        outputText.AppendLine("File size: " + basicProperties.Size + " bytes");
        outputText.AppendLine("Date modified: " + basicProperties.DateModified);

        // 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 GetBasicPropertiesAsync terminé, basicProperties obtient un objet BasicProperties.

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 BasicProperties de manière asynchrone à l’aide de la méthode GetBasicPropertiesAsync d’un élément (comme un fichier de dossier), ou de manière synchrone à l’aide de la propriété BasicProperties si elle est disponible.

Vous pouvez obtenir un objet BasicProperties à l’aide de l’une des méthodes et propriétés suivantes :

Propriétés

DateModified	Obtient l’horodatage de la dernière modification du fichier.
ItemDate	Obtient la date la plus pertinente pour l’élément.
Size	Obtient la taille du fichier en octets.

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.

S’applique à

Partager via