CaseInsensitiveComparer.Compare(Object, Object) Método

Referência

Definição

Namespace:: System.Collections

Assemblies:: mscorlib.dll, System.Collections.NonGeneric.dll

Assembly:: System.Collections.NonGeneric.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: CaseInsensitiveComparer.cs

Origem:: CaseInsensitiveComparer.cs

Origem:: CaseInsensitiveComparer.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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);

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.

Aplica-se a

Compartilhar via