CaseInsensitiveComparer Classe

Définition

Compare deux objets pour l’équivalence, ignorant la casse des chaînes.

public ref class CaseInsensitiveComparer : System::Collections::IComparer
public class CaseInsensitiveComparer : System.Collections.IComparer
[System.Serializable]
public class CaseInsensitiveComparer : System.Collections.IComparer
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class CaseInsensitiveComparer : System.Collections.IComparer
type CaseInsensitiveComparer = class
    interface IComparer
[<System.Serializable>]
type CaseInsensitiveComparer = class
    interface IComparer
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CaseInsensitiveComparer = class
    interface IComparer
Public Class CaseInsensitiveComparer
Implements IComparer
Héritage
CaseInsensitiveComparer
Attributs
Implémente

Exemples

L’exemple de code suivant crée une table de hachage respectant la casse et une table de hachage sans respect de la casse et illustre la différence dans leur comportement, même si les deux contiennent les mêmes éléments.

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

*/
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

End Class


'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

Remarques

CaseInsensitiveComparer implémente l’interface prenant en charge les comparaisons qui ne respectent pas la IComparer casse sur les chaînes, tout comme CaseInsensitiveHashCodeProvider l’interface prenant en charge les comparaisons non sensibles à la IHashCodeProvider casse sur les chaînes.

Important

Nous vous déconseillons d’utiliser la classe pour le CaseInsensitiveComparer nouveau développement. Au lieu de cela, nous vous recommandons d’utiliser l’objet System.StringComparer retourné par le StringComparer.CurrentCultureIgnoreCase, StringComparer.InvariantCultureIgnoreCaseou StringComparer.OrdinalIgnoreCase la propriété.

La Comparer classe est l’implémentation par défaut de l’interface et effectue des comparaisons de chaînes sensibles à la IComparer casse.

Les objets utilisés comme clés par un Hashtable sont nécessaires pour remplacer la Object.GetHashCode méthode (ou l’interface IHashCodeProvider ) et la Object.Equals méthode (ou l’interface IComparer ). L’implémentation des deux méthodes ou interfaces doit gérer la sensibilité de la casse de la même façon ; sinon, le Hashtable comportement peut se comporter de manière incorrecte. Par exemple, lors de la création d’un Hashtable, vous devez utiliser cette classe avec la classe ou toute implémentation sans respect IHashCodeProvider de la CaseInsensitiveHashCodeProvider casse.

Les comparaisons de chaînes peuvent avoir des résultats différents en fonction de la culture. Pour plus d’informations sur les comparaisons propres à la culture, consultez l’espace de noms et la System.Globalizationglobalisation et la localisation.

Constructeurs

Nom Description
CaseInsensitiveComparer()

Initialise une nouvelle instance de la CaseInsensitiveComparer classe à l’aide du CurrentCulture thread actuel.

CaseInsensitiveComparer(CultureInfo)

Initialise une nouvelle instance de la CaseInsensitiveComparer classe à l’aide du .CultureInfo

Propriétés

Nom Description
Default

Obtient une instance de CaseInsensitiveComparer ce qui est associée au CurrentCulture thread actuel et qui est toujours disponible.

DefaultInvariant

Obtient une instance de CaseInsensitiveComparer ce qui est associée InvariantCulture et qui est toujours disponible.

Méthodes

Nom Description
Compare(Object, Object)

Effectue une comparaison sans respect de la casse de deux objets du même type et retourne une valeur indiquant si un objet est inférieur, égal ou supérieur à l’autre.

Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi