Partager via

Cache des propriétés

  • Article

Le cache des propriétés est un cache local utilisé pour stocker les données des propriétés contenues dans l'annuaire. Cela vous permet de lire les propriétés ou de modifier les données des propriétés sans effectuer de connexion directe avec le serveur. En limitant ainsi les connexions au serveur, vous optimisez les performances du réseau. Les méthodes CommitChanges et RefreshCache permettent d'échanger des données entre le serveur et le cache des propriétés. Ces méthodes appartiennent à la classe DirectoryEntry.

Les fonctions de la méthode CommitChanges sont les mêmes que celles de la méthode SetInfo dans ADSI. Elle enregistre les données depuis le cache des propriétés vers l'annuaire. Cette méthode permet de modifier de nombreuses propriétés sur un objet avant de les valider dans l'annuaire. Lorsque vous modifiez des propriétés sur plusieurs objets, validez les modifications des propriétés sur un objet avant de modifier les propriétés sur l'objet suivant. Pour plus d'informations sur la méthode SetInfo, voir la rubrique IADs::SetInfo dans MSDN Library à l'adresse https://go.microsoft.com/fwlink/?LinkID=27252.

Les fonctions de la méthode RefreshCache sont les mêmes que celles de la méthode GetInfo dans ADSI. Elle charge les valeurs pour toutes les propriétés des objets depuis le magasin d'annuaires sous-jacent vers le cache des propriétés local. Pour plus d'informations sur la méthode SetInfo, voir la rubrique IADs::GetInfo dans MSDN Library à l'adresse https://go.microsoft.com/fwlink/?LinkID=27252.

Remarque :
Si vous modifiez des propriétés, utilisez la méthode CommitChanges pour enregistrer les modifications apportées à l'annuaire avant d'appeler RefreshCache, sinon les modifications seront perdues lors de l'actualisation.

Lorsque vous modifiez les propriétés, vous devez comprendre la propriété UsePropertyCache de la classe DirectoryEntry. Lorsque UsePropertyCache est défini sur sa valeur par défaut , à savoir true, CommitChanges doit être appelé afin de valider les modifications apportées à l'annuaire. Lorsqu'il est défini sur false, les modifications de l'annuaire sont automatiquement effectuées.

Voir aussi

Référence

System.DirectoryServices
DirectoryEntry

Concepts

Propriétés des objets d'annuaire

Send comments about this topic to Microsoft.

Copyright © 2007 par Microsoft Corporation. Tous droits réservés.