CaseInsensitiveComparer Sınıf

Başvuru

Tanım

Ad Alanı:: System.Collections

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.Collections.NonGeneric.dll

Bütünleştirilmiş Kod:: System.Collections.NonGeneric.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Dizelerin büyük/küçük harflerini yoksayarak, denklik için iki nesneyi karşılaştırır.

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

Devralma: Object
CaseInsensitiveComparer

Öznitelikler: SerializableAttribute ComVisibleAttribute

Uygulamalar: IComparer

Örnekler

Aşağıdaki kod örneği, büyük/küçük harfe duyarlı karma tablosu ve büyük/küçük harfe duyarlı olmayan bir karma tablo oluşturur ve her ikisi de aynı öğeleri içerse bile davranışlarındaki farkı gösterir.

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

Açıklamalar

CaseInsensitiveComparerdizelerde IComparer büyük/küçük harfe duyarsız karşılaştırmaları destekleyen arabirimini uyguladığı IHashCodeProvider gibi CaseInsensitiveHashCodeProvider dizelerde büyük/küçük harfe duyarsız karşılaştırmaları destekleyen arabirimi uygular.

Önemli

sınıfını CaseInsensitiveComparer yeni geliştirme için kullanmanızı önermiyoruz. Bunun yerine, , StringComparer.InvariantCultureIgnoreCaseveya StringComparer.OrdinalIgnoreCase özelliği tarafından StringComparer.CurrentCultureIgnoreCasedöndürülen nesneyi kullanmanızı System.StringComparer öneririz.

Comparer sınıfı arabiriminin varsayılan uygulamasıdır IComparer ve büyük/küçük harfe duyarlı dize karşılaştırmaları gerçekleştirir.

tarafından anahtar Hashtable olarak kullanılan nesnelerin yöntemini (veya arabirimini) ve Object.Equals yöntemini (veya IHashCodeProvider arabiriminiIComparer) geçersiz kılmak Object.GetHashCode için gereklidir. Hem yöntemlerin hem de arabirimlerin uygulanması büyük/küçük harf duyarlılığını aynı şekilde ele almalıdır; aksi takdirde, Hashtable yanlış davranabilir. Örneğin, oluştururken Hashtablebu sınıfı sınıfıyla veya büyük/küçük harfe duyarlı IHashCodeProvider olmayan herhangi bir uygulamayla CaseInsensitiveHashCodeProvider kullanmanız gerekir.

Dize karşılaştırmaları kültüre bağlı olarak farklı sonuçlara sahip olabilir. Kültüre özgü karşılaştırmalar hakkında daha fazla bilgi için bkz System.Globalization . ad alanı ve Genelleştirme ve Yerelleştirme.

Oluşturucular

CaseInsensitiveComparer()	Geçerli iş parçacığını CaseInsensitiveComparer kullanarak CurrentCulture sınıfının yeni bir örneğini başlatır.
CaseInsensitiveComparer(CultureInfo)	Belirtilen CultureInfokullanarak sınıfının yeni bir örneğini CaseInsensitiveComparer başlatır.

Özellikler

Default	Geçerli iş parçacığının CaseInsensitiveComparer ile CurrentCulture ilişkili olan ve her zaman kullanılabilen bir örneğini alır.
DefaultInvariant	İlişkili CaseInsensitiveComparer InvariantCulture olan ve her zaman kullanılabilir olan bir örneğini alır.

Yöntemler

Compare(Object, Object)	Aynı türdeki iki nesnenin büyük/küçük harfe duyarsız bir karşılaştırmasını gerçekleştirir ve birinin diğerinden küçük, buna eşit veya ondan büyük olduğunu belirten bir değer döndürür.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Şunlara uygulanır