CompareModeメソッド

Dictionaryオブジェクトの文字列キーを比較するための比較モードを設定して戻します。

構文

object.CompareMode[ = compare]

引数:

• Object: 必須。常にDictionaryオブジェクトの名前。

• Compare: オプション。指定した場合、compareは比較モードを表す値です。使用可能な値は、0 (バイナリ)、1 (テキスト)、2 (データベース)です。2より大きい値を使用して、特定のロケールID (LCID)を使用した比較を参照できます。

備考

すでにデータが含まれているDictionaryオブジェクトの比較モードを変更しようとすると、エラーが発生します。

次の例では、CompareModeプロパティの使用方法を示します:

例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.

例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