StringComparer Класс

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

StringComparer.cs

Представляет операции сравнения строк, в которых используются правила сравнения с учетом регистра, языка и региональных параметров или правил сравнения по порядковому номеру.

C#

public abstract class StringComparer : System.Collections.Generic.IComparer<string>, System.Collections.Generic.IEqualityComparer<string>, System.Collections.IComparer, System.Collections.IEqualityComparer

Наследование

Object

StringComparer

Реализации

IComparer<String> IEqualityComparer<String> IComparer IEqualityComparer

Примеры

В следующем примере показаны свойства и Create метод StringComparer класса . В этом примере показано, как различные StringComparer объекты сортируют три версии латинской буквы I.

C#

// This example demonstrates members of the 
// System.StringComparer class.

using System;
using System.Collections;
using System.Collections.Generic;
using System.Globalization;
using System.Threading;

class Sample 
{
    public static void Main() 
    {
        // Create a list of string.
        List<string> list = new List<string>();

        // Get the tr-TR (Turkish-Turkey) culture.
        CultureInfo turkish = new CultureInfo("tr-TR");

        // Get the culture that is associated with the current thread.
        CultureInfo thisCulture = Thread.CurrentThread.CurrentCulture;

        // Get the standard StringComparers.
        StringComparer invCmp =   StringComparer.InvariantCulture;
        StringComparer invICCmp = StringComparer.InvariantCultureIgnoreCase;
        StringComparer currCmp = StringComparer.CurrentCulture;
        StringComparer currICCmp = StringComparer.CurrentCultureIgnoreCase;
        StringComparer ordCmp = StringComparer.Ordinal;
        StringComparer ordICCmp = StringComparer.OrdinalIgnoreCase;

        // Create a StringComparer that uses the Turkish culture and ignores case.
        StringComparer turkICComp = StringComparer.Create(turkish, true);

        // Define three strings consisting of different versions of the letter I.
        // LATIN CAPITAL LETTER I (U+0049)
        string capitalLetterI = "I";  

        // LATIN SMALL LETTER I (U+0069)
        string smallLetterI   = "i";

        // LATIN SMALL LETTER DOTLESS I (U+0131)
        string smallLetterDotlessI = "\u0131";

        // Add the three strings to the list.
        list.Add(capitalLetterI);
        list.Add(smallLetterI);
        list.Add(smallLetterDotlessI);

        // Display the original list order.
        Display(list, "The original order of the list entries...");

        // Sort the list using the invariant culture.
        list.Sort(invCmp);
        Display(list, "Invariant culture...");
        list.Sort(invICCmp);
        Display(list, "Invariant culture, ignore case...");

        // Sort the list using the current culture.
        Console.WriteLine("The current culture is \"{0}\".", thisCulture.Name);
        list.Sort(currCmp);
        Display(list, "Current culture...");
        list.Sort(currICCmp);
        Display(list, "Current culture, ignore case...");

        // Sort the list using the ordinal value of the character code points.
        list.Sort(ordCmp);
        Display(list, "Ordinal...");
        list.Sort(ordICCmp);
        Display(list, "Ordinal, ignore case...");

        // Sort the list using the Turkish culture, which treats LATIN SMALL LETTER 
        // DOTLESS I differently than LATIN SMALL LETTER I.
        list.Sort(turkICComp);
        Display(list, "Turkish culture, ignore case...");
    }

    public static void Display(List<string> lst, string title)
    {
        Char c;
        int  codePoint;
        Console.WriteLine(title);
        foreach (string s in lst)
        {
            c = s[0];
            codePoint = Convert.ToInt32(c);
            Console.WriteLine("0x{0:x}", codePoint); 
        }
        Console.WriteLine();
    }
}
/*
This code example produces the following results:

The original order of the list entries...
0x49
0x69
0x131

Invariant culture...
0x69
0x49
0x131

Invariant culture, ignore case...
0x49
0x69
0x131

The current culture is "en-US".
Current culture...
0x69
0x49
0x131

Current culture, ignore case...
0x49
0x69
0x131

Ordinal...
0x49
0x69
0x131

Ordinal, ignore case...
0x69
0x49
0x131

Turkish culture, ignore case...
0x131
0x49
0x69

*/

Комментарии

Дополнительные сведения об этом API см. в разделе Дополнительные примечания API для StringComparer.

Конструкторы

StringComparer()

Инициализирует новый экземпляр класса StringComparer.

Свойства

CurrentCulture	Получает объект StringComparer, выполняющий сравнение строк с учетом регистра, используя правила сравнения строк по словам для текущего языка и региональных параметров.
CurrentCultureIgnoreCase	Получает объект StringComparer, выполняющий сравнения строк без учета регистра, используя правила сравнения строк по словам для текущего языка и региональных параметров.
InvariantCulture	Возвращает объект StringComparer, выполняющий сравнение строк с учетом регистра, используя правила сравнения строк по словам для инвариантного языка и региональных параметров.
InvariantCultureIgnoreCase	Возвращает объект StringComparer, выполняющий сравнение строк без учета регистра, используя правила сравнения строк по словам для инвариантного языка и региональных параметров.
Ordinal	Возвращает объект StringComparer, выполняющий сравнение строк по порядковому номеру с учетом регистра.
OrdinalIgnoreCase	Возвращает объект StringComparer, выполняющий сравнение строк по порядковому номеру без учета регистра.

Методы

Compare(Object, Object)	При переопределении в производном классе сравнивает два объекта и возвращает сведения об их относительном порядке сортировки.
Compare(String, String)	При переопределении в производном классе сравнивает две строки и возвращает сведения об их относительном порядке сортировки.
Create(CultureInfo, Boolean)	Создает объект StringComparer и сравнивает строки в соответствии с правилами заданного языка и региональных параметров.
Create(CultureInfo, CompareOptions)	Создает объект StringComparer, который сравнивает строки в соответствии с правилами заданного языка и региональных параметров и параметрами строки.
Equals(Object, Object)	При переопределении в производном классе позволяет определить, равны ли два объекта.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Equals(String, String)	При переопределении в производном классе позволяет определить, равны ли две строки.
FromComparison(StringComparison)	Преобразует указанный экземпляр StringComparison в экземпляр StringComparer.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetHashCode(Object)	При переопределении в производном классе возвращает хэш-код для указанного объекта.
GetHashCode(String)	При переопределении в производном классе возвращает хэш-код указанной строки.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsWellKnownCultureAwareComparer(IEqualityComparer<String>, CompareInfo, CompareOptions)	Определяет, является ли указанный IEqualityComparer<T> объект хорошо известным строковым компаратором с учетом языка и региональных параметров.
IsWellKnownOrdinalComparer(IEqualityComparer<String>, Boolean)	Определяет, является ли указанный IEqualityComparer<T> компаратором хорошо известной порядковой строки.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Применяется к

См. также раздел

• String
• CompareOptions