Objeto de Dicionário ASP
O objeto Dicionário armazena informações em pares nome/valor.
Mais exemplos
Como criar um objeto Dictionary e, em seguida, usar o método Exists para verificar se existe uma chave especificada.
Como usar o método Items para retornar uma matriz de todos os itens.
Como usar o método Keys para retornar uma matriz de todas as chaves.
Como usar a propriedade Item para retornar o valor de um item.
Como usar a propriedade Key para definir uma chave em um objeto Dicionário.
Como usar a propriedade Count para retornar o número de pares chave/item.
O objeto do dicionário
O objeto Dicionário é usado para armazenar informações em pares nome/valor (referidos como chave e item). O objeto Dictionary pode parecer semelhante a Arrays, no entanto, o objeto Dictionary é uma solução mais desejável para manipular dados relacionados.
Comparando Dicionários e Arrays:
- As chaves são usadas para identificar os itens em um objeto Dicionário
- Você não precisa chamar ReDim para alterar o tamanho do objeto Dicionário
- Ao excluir um item de um Dicionário, os itens restantes serão deslocados automaticamente para cima
- Dicionários não podem ser multidimensionais, Arrays podem
- Dicionários têm mais funções internas do que Arrays
- Dicionários funcionam melhor do que arrays para acessar elementos aleatórios com frequência
- Dicionários funcionam melhor do que arrays na localização de itens por seu conteúdo
O exemplo a seguir cria um objeto Dictionary, adiciona alguns pares de chave/item a ele e recupera o valor do item para a chave gr:
<%
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("The value of key gr is: " & d.Item("gr"))
%>
Output:
The value of key gr is: Green
As propriedades e métodos do objeto Dicionário estão descritos abaixo:
Propriedades
| Property | Description |
|---|---|
| CompareMode | Sets or returns the comparison mode for comparing keys in a Dictionary object |
| Count | Returns the number of key/item pairs in a Dictionary object |
| Item | Sets or returns the value of an item in a Dictionary object |
| Key | Sets a new key value for an existing key value in a Dictionary object |
Métodos
| Method | Description |
|---|---|
| Add | Adds a new key/item pair to a Dictionary object |
| Exists | Returns a Boolean value that indicates whether a specified key exists in the Dictionary object |
| Items | Returns an array of all the items in a Dictionary object |
| Keys | Returns an array of all the keys in a Dictionary object |
| Remove | Removes one specified key/item pair from the Dictionary object |
| RemoveAll | Removes all the key/item pairs in the Dictionary object |