Share via


CompareMode Property 

Sets and returns the comparison mode for comparing string keys in a Dictionary object.


object.CompareMode[ = compare]

Arguments

  • object
    Required. Always the name of a Dictionary object.
  • compare
    Optional. If provided, compare is a value representing the comparison mode. Acceptable values are 0 (Binary), 1 (Text), 2 (Database). Values greater than 2 can be used to refer to comparisons using specific Locale IDs (LCID).

Remarks

An error occurs if you try to change the comparison mode of a Dictionary object that already contains data.

The following example illustrates the use of the CompareMode property:

function TestCompareMode(key)

{

   // Create some variables.

   var a, d; 

   var BinaryCompare = 0, TextCompare = 1;

   d = new ActiveXObject("Scripting.Dictionary");

   // Set Compare mode to Text.

   d.CompareMode = TextCompare;

   // Add some keys and items.

   d.Add("a", "Athens"); 

   d.Add("b", "Belgrade");

   d.Add("c", "Cairo");

   return(d.Item(key));

}
Dim d

Set d = CreateObject("Scripting.Dictionary")



d.CompareMode = vbTextCompare

d.Add "a", "Athens"   ' Add some keys and items.

d.Add "b", "Belgrade"

d.Add "c", "Cairo"

d.Add "B", "Baltimore"   ' Add method fails on this line because the 

                         ' letter b already exists in the Dictionary.

Applies To:

Dictionary Object

See Also

Reference

Key Property