Objet Dictionary ASP

L'objet Dictionary est utilisé pour stocker des informations dans des paires de noms/valeurs (équivalent à clé et élément).

Exemple

La clé spécifiée existe-t-elle ?
Cet exemple montre comment, d'abord créer un objet Dictionary, puis utiliser la méthode Exists pour vérifier si une clé spécifique existe.
Retourner un tableau de tous les éléments
Cet exemple montre comment utiliser la méthode Items pour retourner un tableau de tous les éléments.
Retourner un tableau de toutes les clés
Cet exemple montre comment utiliser la méthode Keys pour retourner un tableau de toutes les clés.
Retourner la valeur d'un élément
Cet exemple montre comment utiliser la propriété Item pour retourner la valeur d'un élément.
Définir une clé
Cet exemple montre comment utiliser la propriété Key pour définir une clé dans l'objet Dictionary.
Retourner le nombre de couples clé/valeur
Cet exemple montre comment utiliser la propriété Count pour retourner le nombre de couples clé/valeur.

Objet Dictionary

L'objet Dictionary est utilisé pour stocker des informations dans des paires nom/valeur (équivalent à clé et élément). Bien que l'objet Dictionary semble plus simple que l'array, il est toutefois une solution plus satisfaisante pour le traitement des données associées.

Comparaison Dictionary et array :

  • Les clés sont utilisées pour identifier les éléments de l'objet Dictionary.
  • Vous n'avez pas besoin d'appeler ReDim pour changer la taille de l'objet Dictionary.
  • Lorsque vous supprimez un élément du Dictionary, les autres éléments sont automatiquement déplacés.
  • Le Dictionary n'est pas multidimensionnel, contrairement à l'array.
  • Le Dictionary offre plus d'objets intégrés que l'array.
  • Le Dictionary fonctionne mieux que l'array lors d'accès fréquents à des éléments aléatoires.
  • Le Dictionary fonctionne mieux que l'array pour localiser des éléments en fonction de leur contenu.

L'exemple suivant crée un objet Dictionary et ajoute quelques couples clé/valeur à cet objet, puis récupère la valeur de la clé bl :

<%
Dim d
Set d=Server.CreateObject("Scripting.Dictionary")
d.Add "re","Rouge"
d.Add "gr","Vert"
d.Add "bl","Bleu"
d.Add "pi","Rose"
Response.Write("La valeur de la clé bl est : " & d.Item("bl"))
%>

Sortie :

La valeur de la clé bl est : Bleu

Voici la description des propriétés et des méthodes de l'objet Dictionary :

Propriété

Propriété Description
CompareMode Définit ou retourne le mode de comparaison utilisé pour comparer les clés dans l'objet Dictionary.
Count Retourne le nombre de couples clé/valeur dans l'objet Dictionary.
Item Définit ou retourne la valeur d'un élément dans l'objet Dictionary.
Key Définit de nouvelles valeurs pour les clés existantes de l'objet Dictionary.

Méthode

Méthode Description
Add Ajoute un nouveau couple clé/valeur à l'objet Dictionary.
Exists Retourne une valeur logique, indiquant si la clé spécifiée existe dans l'objet Dictionary.
Items Retourner un tableau de tous les éléments de l'objet Dictionary.
Keys Retourner un tableau de toutes les clés de l'objet Dictionary.
Remove Supprimer les paires de clé/élément spécifiées de l'objet Dictionary.
RemoveAll Supprimer tous les paires de clés/éléments dans l'objet Dictionary.