CaseInsensitiveHashCodeProvider Classe

Definição

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Origem:

CaseInsensitiveHashCodeProvider.cs

Cuidado

CaseInsensitiveHashCodeProvider has been deprecated. Use StringComparer instead.

Fornece um código hash para um objeto, usando um algoritmo de hash que não diferencia maiúsculas de minúsculas em cadeias de caracteres.

C#

[System.Obsolete("CaseInsensitiveHashCodeProvider has been deprecated. Use StringComparer instead.")]
public class CaseInsensitiveHashCodeProvider : System.Collections.IHashCodeProvider

Herança

Object

CaseInsensitiveHashCodeProvider

Atributos

ObsoleteAttribute

Implementações

IHashCodeProvider

Exemplos

O exemplo de código a seguir cria uma tabela de hash que diferencia maiúsculas de minúsculas e uma tabela de hash que não diferencia maiúsculas de minúsculas e demonstra a diferença em seu comportamento, mesmo que ambos contenham os mesmos elementos.

C#

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

*/

Comentários

CaseInsensitiveHashCodeProvider implementa a interface que dá suporte a IHashCodeProvider comparações que não diferenciam maiúsculas de minúsculas em cadeias de caracteres, assim como CaseInsensitiveComparer implementa a interface que dá suporte a IComparer comparações que não diferenciam maiúsculas de minúsculas em cadeias de caracteres.

Importante

Não recomendamos que você use a CaseInsensitiveHashCodeProvider classe para novo desenvolvimento. Em vez disso, recomendamos que você use o System.StringComparer objeto retornado pela StringComparer.CurrentCultureIgnoreCasepropriedade , StringComparer.InvariantCultureIgnoreCaseou StringComparer.OrdinalIgnoreCase .

Os objetos usados como chaves por um Hashtable são necessários para substituir o Object.GetHashCode método (ou a IHashCodeProvider interface) e o Object.Equals método (ou a IComparer interface). A implementação de ambos os métodos ou interfaces deve lidar com a confidencialidade de maiúsculas e minúsculas da mesma maneira; caso contrário, o Hashtable pode se comportar incorretamente. Por exemplo, ao criar um Hashtable, você deve usar essa classe com a CaseInsensitiveComparer classe ou qualquer implementação que não diferencia maiúsculas de minúsculas IComparer .

Construtores

CaseInsensitiveHashCodeProvider()	Obsoleto. Inicializa uma nova instância da classe CaseInsensitiveHashCodeProvider usando o CurrentCulture do thread atual.
CaseInsensitiveHashCodeProvider(CultureInfo)	Obsoleto. Inicializa uma nova instância da classe CaseInsensitiveHashCodeProvider usando o CultureInfo especificado.

Propriedades

Default	Obsoleto. Obtém uma instância de CaseInsensitiveHashCodeProvider que está associada ao CurrentCulture do thread atual e que está sempre disponível.
DefaultInvariant	Obsoleto. Obtém uma instância de CaseInsensitiveHashCodeProvider que está associada ao InvariantCulture e que está sempre disponível.

Métodos

Equals(Object)	Obsoleto. Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Obsoleto. Serve como a função de hash padrão. (Herdado de Object)
GetHashCode(Object)	Obsoleto. Retorna um código hash para o objeto específico, usando um algoritmo de hash que não diferencia maiúsculas de minúsculas em cadeias de caracteres.
GetType()	Obsoleto. Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Obsoleto. Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Obsoleto. Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Confira também

• Hashtable
• IHashCodeProvider
• CurrentCulture
• CultureInfo
• CaseInsensitiveComparer
• Executando operações de cadeia de caracteres Culture-Insensitive em coleções