O objeto Dictionary armazena informações em pares nome / valor.
Exemplos
Será que uma chave especificada existe?
Como criar um objeto Dictionary, e então usar o método Exists para verificar se existe uma chave especificada.
Retorna uma matriz de todos os itens
Como utilizar o método Items para retornar uma matriz de todos os itens.
Retorna uma matriz de todas as chaves
Como usar as chaves método para retornar uma matriz de todas as chaves.
Devolver o valor de um item
Como usar a propriedade Item para retornar o valor de um item.
Definir uma chave
Como usar a propriedade de chave para definir uma chave em um objeto Dictionary.
Retorna o número de pares chave / itens
Como usar a propriedade Count para retornar o número de pares de chave / item.
O dicionário de objetos
O objeto Dictionary é usado para armazenar informações em pares nome / valor (referred to as key and item) . O objecto dicionário pode parecer semelhante à matrizes, no entanto, o objecto dicionário é uma solução mais desejável para manipular os dados relacionados.
Comparando dicionários e matrizes:
- As chaves são utilizadas para identificar os itens em um objeto Dictionary
- Você não tem que chamar ReDim para alterar o tamanho do objeto Dicionário
- Ao excluir um item de um dicionário, os itens restantes mudará automaticamente
- Dicionários não podem ser multidimensional, matrizes podem
- Dicionários têm mais funções embutidas que Arrays
- Dicionários funcionam melhor do que as matrizes sobre o acesso a elementos aleatórios freqüentemente
- Dicionários funcionam melhor do que as matrizes sobre a localização de itens pelo seu conteúdo
O exemplo a seguir cria um objeto Dictionary, adiciona alguns pares de chave / itens a ele, e recupera o valor do item para o gr chave:
<%
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: Greenpropriedades e métodos do objecto dicionário são descritos abaixo:
propriedades
| Propriedade | Descrição |
|---|---|
| CompareMode | Define ou retorna o modo de comparação para comparar chaves em um objeto Dictionary |
| Count | Retorna o número de pares de chave / item em um objeto Dictionary |
| Item | Define ou retorna o valor de um item em um objeto Dictionary |
| Key | Define um novo valor de chave para um valor de chave existente em um objeto Dictionary |
Métodos
| Método | Descrição |
|---|---|
| Add | Adiciona um novo par chave / item para um objeto Dictionary |
| Exists | Retorna um valor booleano que indica se uma chave especificada existe no objeto Dictionary |
| Items | Retorna uma matriz de todos os itens em um objeto Dictionary |
| Keys | Retorna uma matriz de todas as chaves de um objeto Dictionary |
| Remove | Remove um par chave / item especificado do objeto Dicionário |
| RemoveAll | Remove todos os pares de chave / itens no objeto Dicionário |