Método Add

Adiciona um par de chave/item a um objeto Dictionary.

Sintaxe

object.Add(key, item)

Argumentos:

  • Object: Obrigatório. Sempre o nome de um objeto Dictionary.

  • Key: Obrigatório. A chave associada ao item a ser adicionado.

  • Item: Obrigatório. O item associado à chave a ser adicionada.

Comentários

Ocorrerá um erro se a chave já existir.

O exemplo a seguir ilustra o uso do método Add.

Exemplo 1:

Dim d   ' Create a variable.
Set d = CreateObject("Scripting.Dictionary")

' Add some keys and items.
d.Add "a", "Athens"
d.Add "b", "Belgrade"
d.Add "c", "Cairo"
' Output: Dictionary Object Contains Keys: a,b,c Items: Athens,Belgrade,Cairo

Exemplo 2:

Dim d
Set d = CreateObject("Scripting.Dictionary")

' Add some keys and items.
If Not d.Exists("a") Then
    d.Add "a", "Athens"
End If

If Not d.Exists("b") Then
    d.Add "b", "Belgrade"
End If

If Not d.Exists("c") Then
    d.Add "c", "Cairo"
End If
' Output: Dictionary Object Contains Keys: a,b,c Items: Athens,Belgrade,Cairo

Exemplo 3:

Dim d
Set d = CreateObject("Scripting.Dictionary")

Dim arrKeys, arrItems
arrKeys = Array("a", "b", "c")
arrItems = Array("Athens", "Belgrade", "Cairo")

For i = 0 To UBound(arrKeys)
    d.Add arrKeys(i), arrItems(i)
Next
' Output: Dictionary Object Contains Keys: a,b,c Items: Athens,Belgrade,Cairo

Note:

Não há suporte para a criação de objeto na chamada de adição ao dicionário.

Por exemplo:

Set d = CreateObject("Scripting.Dictionary")

'Create an object first and then add it to the dictionary.

Set obj = new class

d.add key, obj Isso é suportado.