Objeto Dicionário ASP

O objeto Dictionary é usado para armazenar informações em pares de nome/valor (equivalente a chave e item).

Exemplo

A chave especificada existe?
Este exemplo demonstra como, primeiramente, criar um objeto Dictionary e, em seguida, usar o método Exists para verificar se a chave especificada existe.
Retornar um array de todos os itens
Este exemplo demonstra como usar o método Items para retornar um array de todos os itens.
Retornar um array de todas as chaves
Este exemplo demonstra como usar o método Keys para retornar um array de todas as chaves.
Retornar o valor de um item
Este exemplo demonstra como usar a propriedade Item para retornar o valor de um item.
Definir uma chave
Este exemplo demonstra como usar a propriedade Key para definir uma chave no objeto Dictionary.
Retorna o número de pares de chave/valor
Este exemplo demonstra como usar a propriedade Count para retornar o número de pares de chave/valor.

Objeto Dictionary

O objeto Dictionary é usado para armazenar informações em pares de nome/valor (equivalente a chave e item). Embora o objeto Dictionary pareça mais simples do que o array, ele é uma solução mais satisfatória para o tratamento de dados associativos.

Comparação entre Dictionary e array:

  • As chaves são usadas para identificar itens no objeto Dictionary
  • Não é necessário chamar ReDim para alterar o tamanho do objeto Dictionary
  • Quando um item é removido do Dictionary, os outros itens se movem automaticamente para cima
  • O Dictionary não é multidimensional, enquanto o array é
  • O Dictionary possui mais objetos embutidos do que o array
  • O Dictionary funciona melhor ao acessar elementos randômicos frequentemente do que o array
  • O Dictionary funciona melhor ao localizar itens com base em seu conteúdo do que o array

O exemplo a seguir cria um objeto Dictionary e adiciona alguns pares de chave/valor ao objeto, retornando o valor da chave 'bl':

<%
Dim d
Set d=Server.CreateObject("Scripting.Dictionary")
d.Add "re","Red"
d.Add "gr","Green"
d.Add "bl","Blue"
d.Add "pi","Pink"
Response.Write("O valor da chave 'bl' é: " & d.Item("bl"))
%>

Saída:

O valor da chave 'bl' é: Azul

A seguir, estão descritas as propriedades e métodos do objeto Dictionary:

Propriedade

Propriedade Descrição
CompareMode Define ou retorna o modo de comparação usado para comparar chaves no objeto Dictionary.
Count Retorna o número de pares de chave/valor no objeto Dictionary.
Item Define ou retorna o valor de um item no objeto Dictionary.
Key Define novos valores de chave para um valor existente no objeto Dictionary.

Método

Método Descrição
Add Adiciona um novo par de chave/valor ao objeto Dictionary.
Exists Retorna um valor lógico, que pode indicar se a chave especificada existe no objeto Dictionary.
Items Retorna um array com todos os itens do objeto Dictionary.
Keys Retorna um array com todas as chaves do objeto Dictionary.
Remove Remover o pares de chave/valor especificados do objeto Dictionary.
RemoveAll Remover todos os pares de chave/valor do objeto Dictionary.