CaseInsensitiveHashCodeProvider 类
注意：此类现在已过时。
使用忽略字符串大小写的哈希算法，为对象提供哈希代码。
**命名空间:**System.Collections
**程序集:**mscorlib（在 mscorlib.dll 中）
语法
声明
<SerializableAttribute> _
<ObsoleteAttribute("Please use StringComparer instead.")> _
<ComVisibleAttribute(True)> _
Public Class CaseInsensitiveHashCodeProvider
Implements IHashCodeProvider
用法
Dim instance As CaseInsensitiveHashCodeProvider
[SerializableAttribute]
[ObsoleteAttribute("Please use StringComparer instead.")]
[ComVisibleAttribute(true)]
public class CaseInsensitiveHashCodeProvider : IHashCodeProvider
[SerializableAttribute]
[ObsoleteAttribute(L"Please use StringComparer instead.")]
[ComVisibleAttribute(true)]
public ref class CaseInsensitiveHashCodeProvider : IHashCodeProvider
/** @attribute SerializableAttribute() */
/** @attribute ObsoleteAttribute("Please use StringComparer instead.") */
/** @attribute ComVisibleAttribute(true) */
public class CaseInsensitiveHashCodeProvider implements IHashCodeProvider
SerializableAttribute
ObsoleteAttribute("Please use StringComparer instead.")
ComVisibleAttribute(true)
public class CaseInsensitiveHashCodeProvider implements IHashCodeProvider
备注
CaseInsensitiveHashCodeProvider 实现 IHashCodeProvider 接口，该接口支持对字符串进行不区分大小写的比较，正如 CaseInsensitiveComparer 实现 IComparer 接口（该接口支持对字符串进行不区分大小写的比较）一样。
要重写 Object.GetHashCode 方法（或 IHashCodeProvider 接口）和 Object.Equals 方法（或 IComparer 接口），需要有被 Hashtable 用作键的对象。两个方法或接口的实现必须以相同的方式处理大小写；否则，Hashtable 的行为可能不正确。例如，创建 Hashtable 时，您必须配合使用此类和 CaseInsensitiveComparer 类或任何不区分大小写的 IComparer 实现。
示例
下面的代码示例创建一个区分大小写的哈希表和一个不区分大小写的哈希表，并演示二者行为的差别，甚至是当二者包含相同的元素时各自行为的差别。
Imports System
Imports System.Collections
Imports System.Globalization
Public Class SamplesHashtable
Public Shared Sub Main()
' Create a Hashtable using the default hash code provider and the default comparer.
Dim myHT1 As New Hashtable()
myHT1.Add("FIRST", "Hello")
myHT1.Add("SECOND", "World")
myHT1.Add("THIRD", "!")
' Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
' based on the culture of the current thread.
Dim myHT2 As New Hashtable(New CaseInsensitiveHashCodeProvider(), New CaseInsensitiveComparer())
myHT2.Add("FIRST", "Hello")
myHT2.Add("SECOND", "World")
myHT2.Add("THIRD", "!")
' Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
' based on the InvariantCulture.
Dim myHT3 As New Hashtable(CaseInsensitiveHashCodeProvider.DefaultInvariant, CaseInsensitiveComparer.DefaultInvariant)
myHT3.Add("FIRST", "Hello")
myHT3.Add("SECOND", "World")
myHT3.Add("THIRD", "!")
' Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
' based on the Turkish culture (tr-TR), where "I" is not the uppercase version of "i".
Dim myCul As New CultureInfo("tr-TR")
Dim myHT4 As New Hashtable(New CaseInsensitiveHashCodeProvider(myCul), New CaseInsensitiveComparer(myCul))
myHT4.Add("FIRST", "Hello")
myHT4.Add("SECOND", "World")
myHT4.Add("THIRD", "!")
' Search for a key in each hashtable.
Console.WriteLine("first is in myHT1: {0}", myHT1.ContainsKey("first"))
Console.WriteLine("first is in myHT2: {0}", myHT2.ContainsKey("first"))
Console.WriteLine("first is in myHT3: {0}", myHT3.ContainsKey("first"))
Console.WriteLine("first is in myHT4: {0}", myHT4.ContainsKey("first"))
End Sub 'Main
End Class 'SamplesHashtable
'This code produces the following output. Results vary depending on the system's culture settings.
'
'first is in myHT1: False
'first is in myHT2: True
'first is in myHT3: True
'first is in myHT4: False
using System;
using System.Collections;
using System.Globalization;
public class SamplesHashtable {
public static void Main() {
// Create a Hashtable using the default hash code provider and the default comparer.
Hashtable myHT1 = new Hashtable();
myHT1.Add("FIRST", "Hello");
myHT1.Add("SECOND", "World");
myHT1.Add("THIRD", "!");
// Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
// based on the culture of the current thread.
Hashtable myHT2 = new Hashtable( new CaseInsensitiveHashCodeProvider(), new CaseInsensitiveComparer() );
myHT2.Add("FIRST", "Hello");
myHT2.Add("SECOND", "World");
myHT2.Add("THIRD", "!");
// Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
// based on the InvariantCulture.
Hashtable myHT3 = new Hashtable( CaseInsensitiveHashCodeProvider.DefaultInvariant, CaseInsensitiveComparer.DefaultInvariant );
myHT3.Add("FIRST", "Hello");
myHT3.Add("SECOND", "World");
myHT3.Add("THIRD", "!");
// Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
// based on the Turkish culture (tr-TR), where "I" is not the uppercase version of "i".
CultureInfo myCul = new CultureInfo( "tr-TR" );
Hashtable myHT4 = new Hashtable( new CaseInsensitiveHashCodeProvider( myCul ), new CaseInsensitiveComparer( myCul ) );
myHT4.Add("FIRST", "Hello");
myHT4.Add("SECOND", "World");
myHT4.Add("THIRD", "!");
// Search for a key in each hashtable.
Console.WriteLine( "first is in myHT1: {0}", myHT1.ContainsKey( "first" ) );
Console.WriteLine( "first is in myHT2: {0}", myHT2.ContainsKey( "first" ) );
Console.WriteLine( "first is in myHT3: {0}", myHT3.ContainsKey( "first" ) );
Console.WriteLine( "first is in myHT4: {0}", myHT4.ContainsKey( "first" ) );
}
}
/*
This code produces the following output. Results vary depending on the system's culture settings.
first is in myHT1: False
first is in myHT2: True
first is in myHT3: True
first is in myHT4: False
*/
using namespace System;
using namespace System::Collections;
using namespace System::Globalization;
int main()
{
// Create a Hashtable using the default hash code provider and the default comparer.
Hashtable^ myHT1 = gcnew Hashtable;
myHT1->Add( "FIRST", "Hello" );
myHT1->Add( "SECOND", "World" );
myHT1->Add( "THIRD", "!" );
// Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
// based on the culture of the current thread.
Hashtable^ myHT2 = gcnew Hashtable( gcnew CaseInsensitiveHashCodeProvider,gcnew CaseInsensitiveComparer );
myHT2->Add( "FIRST", "Hello" );
myHT2->Add( "SECOND", "World" );
myHT2->Add( "THIRD", "!" );
// Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
// based on the InvariantCulture.
Hashtable^ myHT3 = gcnew Hashtable( CaseInsensitiveHashCodeProvider::DefaultInvariant,CaseInsensitiveComparer::DefaultInvariant );
myHT3->Add( "FIRST", "Hello" );
myHT3->Add( "SECOND", "World" );
myHT3->Add( "THIRD", "!" );
// Create a Hashtable using a case-insensitive code provider and a case-insensitive comparer,
// based on the Turkish culture (tr-TR), where "I" is not the uppercase version of "i".
CultureInfo^ myCul = gcnew CultureInfo( "tr-TR" );
Hashtable^ myHT4 = gcnew Hashtable( gcnew CaseInsensitiveHashCodeProvider( myCul ),gcnew CaseInsensitiveComparer( myCul ) );
myHT4->Add( "FIRST", "Hello" );
myHT4->Add( "SECOND", "World" );
myHT4->Add( "THIRD", "!" );
// Search for a key in each hashtable.
Console::WriteLine( "first is in myHT1: {0}", myHT1->ContainsKey( "first" ) );
Console::WriteLine( "first is in myHT2: {0}", myHT2->ContainsKey( "first" ) );
Console::WriteLine( "first is in myHT3: {0}", myHT3->ContainsKey( "first" ) );
Console::WriteLine( "first is in myHT4: {0}", myHT4->ContainsKey( "first" ) );
}
/*
This code produces the following output. Results vary depending on the system's culture settings.
first is in myHT1: False
first is in myHT2: True
first is in myHT3: True
first is in myHT4: False
*/
import System.*;
import System.Collections.*;
import System.Globalization.*;
public class SamplesHashtable
{
public static void main(String[] args)
{
// Create a Hashtable using the default hash code provider and the
// default comparer.
Hashtable myHT1 = new Hashtable();
myHT1.Add("FIRST", "Hello");
myHT1.Add("SECOND", "World");
myHT1.Add("THIRD", "!");
// Create a Hashtable using a case-insensitive code provider and a
// case-insensitive comparer, based on the culture of the
// current thread.
Hashtable myHT2 = new Hashtable(new CaseInsensitiveHashCodeProvider(),
new CaseInsensitiveComparer());
myHT2.Add("FIRST", "Hello");
myHT2.Add("SECOND", "World");
myHT2.Add("THIRD", "!");
// Create a Hashtable using a case-insensitive code provider and
// a case-insensitive comparer, based on the InvariantCulture.
Hashtable myHT3 =
new Hashtable(CaseInsensitiveHashCodeProvider.get_DefaultInvariant(),
CaseInsensitiveComparer.get_DefaultInvariant());
myHT3.Add("FIRST", "Hello");
myHT3.Add("SECOND", "World");
myHT3.Add("THIRD", "!");
// Create a Hashtable using a case-insensitive code provider and a
// case-insensitive comparer, based on the Turkish culture (tr-TR),
// where "I" is not the uppercase version of "i".
CultureInfo myCul = new CultureInfo("tr-TR");
Hashtable myHT4 =
new Hashtable(new CaseInsensitiveHashCodeProvider(myCul),
new CaseInsensitiveComparer(myCul));
myHT4.Add("FIRST", "Hello");
myHT4.Add("SECOND", "World");
myHT4.Add("THIRD", "!");
// Search for a key in each hashtable.
Console.WriteLine("first is in myHT1: {0}",
(System.Boolean)myHT1.ContainsKey("first"));
Console.WriteLine("first is in myHT2: {0}",
(System.Boolean)myHT2.ContainsKey("first"));
Console.WriteLine("first is in myHT3: {0}",
(System.Boolean)myHT3.ContainsKey("first"));
Console.WriteLine("first is in myHT4: {0}",
(System.Boolean)myHT4.ContainsKey("first"));
} //main
} //SamplesHashtable
/*
This code produces the following output. Results vary depending on the system's
culture settings.
first is in myHT1: False
first is in myHT2: True
first is in myHT3: True
first is in myHT4: False
*/
继承层次结构
System.Object
System.Collections.CaseInsensitiveHashCodeProvider
线程安全
此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：1.0、1.1
在 2.0 中过时（编译器警告）
.NET Compact Framework
受以下版本支持：1.0
在 2.0 中过时（编译器警告）
请参见
参考
CaseInsensitiveHashCodeProvider 成员
System.Collections 命名空间
Hashtable
IHashCodeProvider
Thread.CurrentCulture
System.Globalization.CultureInfo
CaseInsensitiveComparer 类