CaseInsensitiveComparer.Compare(Object, Object) Método

Definição

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Origem:

CaseInsensitiveComparer.cs

Executa uma comparação que não diferencia maiúsculas de minúsculas de dois objetos do mesmo tipo e retorna um valor que indica se um é menor que, igual a ou maior que o outro.

public:
 virtual int Compare(System::Object ^ a, System::Object ^ b);

public int Compare (object? a, object? b);

abstract member Compare : obj * obj -> int
override this.Compare : obj * obj -> int

Public Function Compare (a As Object, b As Object) As Integer

Parâmetros

a

Object

O primeiro objeto a ser comparado.

b

Object

O segundo objeto a ser comparado.

Retornos

Int32

Um inteiro assinado que indica os valores relativos de a e b, conforme mostrado na tabela a seguir.

Valor	Significado
Menor que zero	a é menor que b, com o uso de maiúsculas ignorado.
Zero	a é igual a b, com o uso de maiúsculas ignorado.
Maior que zero	a é maior que b, com o uso de maiúsculas ignorado.

Implementações

Compare(Object, Object)

Exceções

ArgumentException

Nem a nem b implementam a interface IComparable.

- ou -

a e b são de tipos diferentes.

Comentários

Se a e b forem ambas cadeias CompareInfo.Compare de caracteres, esse método usará para comparar as cadeias de caracteres com a maiúsculas e minúsculas ignoradas; caso contrário, ele usará a IComparable implementação de qualquer objeto. Ou seja, se a implementar IComparable, esse método retornará o resultado de a. CompareTo (b); caso contrário, se b implementar IComparable, retornará o resultado negado de b. CompareTo (a).

A comparação null com qualquer tipo é permitida e não gera uma exceção ao usar IComparable. Durante a classificação, null é considerado menor que qualquer outro objeto.

As comparações de cadeia de caracteres podem ter resultados diferentes dependendo da cultura. Para obter mais informações sobre comparações específicas da cultura, consulte o System.Globalization namespace e Globalização e Localização.

Confira também

• IComparable
• CompareInfo
• CurrentCulture
• CultureInfo
• Executando operações de cadeia de caracteres Culture-Insensitive em coleções