Partager via


BasicProperties Classe

Définition

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
Implémente

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 à

Voir aussi