CaseInsensitiveComparer Klasse

Definition

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Quelle:

CaseInsensitiveComparer.cs

Vergleicht zwei Objekte auf Äquivalenz und ignoriert dabei die Groß- und Kleinschreibung in Zeichenfolgen.

public ref class CaseInsensitiveComparer : System::Collections::IComparer

public class CaseInsensitiveComparer : System.Collections.IComparer

type CaseInsensitiveComparer = class
    interface IComparer

Public Class CaseInsensitiveComparer
Implements IComparer

Vererbung

Object

CaseInsensitiveComparer

Implementiert

IComparer

Beispiele

Im folgenden Codebeispiel werden eine Hashtabelle mit Berücksichtigung der Groß-/Kleinschreibung und eine Hashtabelle ohne Berücksichtigung der Groß-/Kleinschreibung erstellt, und es wird der Unterschied in ihrem Verhalten veranschaulicht, auch wenn beide die gleichen Elemente enthalten.

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

*/

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

Hinweise

CaseInsensitiveComparer implementiert die -Schnittstelle, die IComparer Vergleiche ohne Berücksichtigung der Groß-/Kleinschreibung für Zeichenfolgen unterstützt, ebenso wie CaseInsensitiveHashCodeProvider die Schnittstelle implementiert, die IHashCodeProvider Vergleiche ohne Berücksichtigung der Groß-/Kleinschreibung für Zeichenfolgen unterstützt.

Wichtig

Es wird nicht empfohlen, die CaseInsensitiveComparer -Klasse für die Neuentwicklung zu verwenden. Stattdessen wird empfohlen, das von der System.StringComparerStringComparer.CurrentCultureIgnoreCase- oder StringComparer.InvariantCultureIgnoreCase- StringComparer.OrdinalIgnoreCase Eigenschaft zurückgegebene -Objekt zu verwenden.

Die Comparer -Klasse ist die Standardimplementierung der IComparer Schnittstelle und führt Zeichenfolgenvergleiche zwischen Groß- und Kleinschreibung durch.

Die -Objekte, die von einem Hashtable als Schlüssel verwendet werden, müssen die Object.GetHashCode -Methode (oder die IHashCodeProvider -Schnittstelle) und die Object.Equals -Methode (oder die IComparer -Schnittstelle) überschreiben. Bei der Implementierung beider Methoden oder Schnittstellen muss die Groß-/Kleinschreibung auf die gleiche Weise behandelt werden. Andernfalls verhält sich die Hashtable möglicherweise falsch. Wenn Sie beispielsweise einen Hashtableerstellen, müssen Sie diese Klasse mit der -Klasse oder jeder Implementierung ohne Berücksichtigung IHashCodeProvider der CaseInsensitiveHashCodeProvider Groß-/Kleinschreibung verwenden.

Zeichenfolgenvergleiche können je nach Kultur unterschiedliche Ergebnisse aufweisen. Weitere Informationen zu kulturspezifischen Vergleichen finden Sie unter Namespace System.Globalization und Globalisierung und Lokalisierung.

Konstruktoren

CaseInsensitiveComparer()	Initialisiert eine neue Instanz der CaseInsensitiveComparer-Klasse mit der CurrentCulture des aktuellen Threads.
CaseInsensitiveComparer(CultureInfo)	Initialisiert eine neue Instanz der CaseInsensitiveComparer-Klasse mit dem angegebenen CultureInfo.

Eigenschaften

Default	Ruft eine Instanz von CaseInsensitiveComparer ab, die der CurrentCulture des aktuellen Threads zugeordnet und jederzeit verfügbar ist.
DefaultInvariant	Ruft eine Instanz von CaseInsensitiveComparer ab, die InvariantCulture zugeordnet und jederzeit verfügbar ist.

Methoden

Compare(Object, Object)	Führt einen Vergleich zweier Objekte gleichen Typs ohne Berücksichtigung der Groß- und Kleinschreibung durch und gibt über den zurückgegebenen Wert an, ob das eine Objekt kleiner, größer oder gleich dem anderen Objekt ist.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• IComparer
• IComparable
• Comparer
• CompareInfo
• CurrentCulture
• CultureInfo
• CaseInsensitiveHashCodeProvider
• Durchführen kulturunabhängiger Zeichenfolgenoperationen in Auflistungen