StringComparer.Compare Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Compara dois objetos ou cadeias de caracteres e retorna uma indicação de sua ordem de classificação relativa.

Sobrecargas

Compare(Object, Object)	Quando substituído em uma classe derivada, compara dois objetos e retorna uma indicação de sua ordem de classificação relativa.
Compare(String, String)	Quando substituído em uma classe derivada, compara duas cadeias de caracteres e retorna uma indicação de sua ordem de classificação relativa.

Compare(Object, Object)

Quando substituído em uma classe derivada, compara dois objetos e retorna uma indicação de sua ordem de classificação relativa.

public:
 virtual int Compare(System::Object ^ x, System::Object ^ y);

public int Compare (object? x, object? y);

public int Compare (object x, object y);

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

Public Function Compare (x As Object, y As Object) As Integer

Parâmetros

x

Object

Um objeto a ser comparado com y.

y

Object

Um objeto a ser comparado com x.

Retornos

Int32

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

Valor	Significado
Menor que zero	x precede y na ordem de classificação, ou x é null e y não é null.
Zero	x é igual a y, ou x e y são null.
Maior que zero	x segue y na ordem de classificação, ou y é null e x não é null.

Implementações

Compare(Object, Object)

Exceções

ArgumentException

Nem x nem y é um String objeto e nem x nem y implementa a interface IComparable.

Comentários

O StringComparer.Compare(String, String) método é um pouco mais eficiente do que o StringComparer.Compare(Object, Object) método porque nenhuma conversão e argumentos x y são necessários para executar a comparação.

Compare(String, String)

Quando substituído em uma classe derivada, compara duas cadeias de caracteres e retorna uma indicação de sua ordem de classificação relativa.

public:
 abstract int Compare(System::String ^ x, System::String ^ y);

public abstract int Compare (string x, string y);

public abstract int Compare (string? x, string? y);

abstract member Compare : string * string -> int

Public MustOverride Function Compare (x As String, y As String) As Integer

Parâmetros

x

String

Uma cadeia de caracteres a ser comparada com y.

y

String

Uma cadeia de caracteres a ser comparada com x.

Retornos

Int32

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

Valor	Significado
Menor que zero	x precede y na ordem de classificação, ou x é null e y não é null.
Zero	x é igual a y, ou x e y são null.
Maior que zero	x segue y na ordem de classificação, ou y é null e x não é null.

Implementações

Compare(T, T)

Comentários

O StringComparer.Compare(String, String) método é um pouco mais eficiente do que o StringComparer.Compare(Object, Object) método porque nenhuma conversão e argumentos x y são necessários para executar a comparação.