Método CompareMode

Define e retorna o modo de comparação para comparar chaves de string em um objeto Dictionary.

Sintaxe

object.CompareMode[ = compare]

Argumentos:

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

• Compare: Opcional. Quando fornecido, o argumento compare é um valor que representa o modo de comparação. Os valores aceitáveis são 0 (Binário), 1 (Texto) e 2 (Banco de Dados). Valores maiores que 2 podem ser usados para fazer referência a comparações usando IDs de Local (LCID) específicos.

Comentários

Ocorrerá um erro se você tentar alterar o modo de comparação de um objeto Dictionary que já contenha dados.

O exemplo a seguir ilustra o uso da propriedade CompareMode.

Exemplo 1:

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

    ' Set comparison mode to Text (case-insensitive)
    d.CompareMode = vbTextCompare

    ' Add some keys and items.
    d.Add "a", "Athens"
    d.Add "b", "Belgrade"
    d.Add "c", "Cairo"

    ' Try to add a key that differs only in case
    On Error Resume Next
    d.Add "B", "Baltimore"
    Number = Err.Number
    If Number <> 0 Then
              Msg = "Error: Key 'b' already exists."
        Err.Clear
    End If
    On Error GoTo 0
 End Sub
' Output: Error: Key 'b' already exists.

Exemplo 2:

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

    ' Set comparison mode to Binary (case-sensitive)
    d.CompareMode = vbBinaryCompare

    ' Add some keys and items.
    d.Add "x", "Xenon"
    d.Add "y", "Yttrium"
    d.Add "z", "Zirconium"

    ' Try to add a key "X" which is different from "x"
    d.Add "X", "X-Ray"
 End Sub
' Output: Dictionary Object Contain Keys: x,y,z,X Items: Xenon,Yttrium,Zirconium,X-Ray