KeyCompareMode
返回或设置 Collection 对象中匹配字符串键时使用的比较模式。可读写。
语法:
- object.KeyCompareMode
- object.KeyCompareMode = compare
- object
- 必需 一个计算结果为 Collection 对象的对象表达式。
- compare
- 一个 VbCompareMethod 值,指定 Add、Item、Remove 和 Exists 在查找键时使用的比较模式。
compare 参数设置如下:
| 常量 | 值 | 描述 |
|---|---|---|
| vbBinaryCompare | 0 | 执行区分大小写的二进制比较。 |
| vbTextCompare | 1 | 执行不区分大小写的文本比较。 |
INFO
KeyCompareMode 是 twinBASIC 扩展;经典 VBA 的 Collection 对象始终使用不区分大小写的比较,并且不公开此属性。
默认比较模式为 vbTextCompare。更改比较模式会对现有键重新哈希,因此对于大型集合,最有效的做法是在添加项之前设置 KeyCompareMode。
示例
vb
Dim col As New Collection
' Default mode is binary (case-sensitive).
col.Add "first", Key:="A"
col.Add "second", Key:="a" ' Distinct from "A" — succeeds.
Dim col2 As New Collection
col2.KeyCompareMode = vbTextCompare
col2.Add "first", Key:="A"
' col2.Add "second", Key:="a" ' Would raise an error — same key as "A".另请参阅
- Add 方法
- Exists 方法
- KeyCountHint 属性
- StrComp 函数
- Option Compare 语句