Idioma

Guid.IComparable.CompareTo(Object) Método

Definição

Compara esta instância com um objeto especificado Guid e devolve uma indicação dos seus valores relativos.

 virtual int System.IComparable.CompareTo(System::Object ^ value) = IComparable::CompareTo;
int IComparable.CompareTo(object value);
abstract member System.IComparable.CompareTo : obj -> int
override this.System.IComparable.CompareTo : obj -> int
Function CompareTo (value As Object) As Integer Implements IComparable.CompareTo

Parâmetros

value
Object

Um objeto para comparar com este caso.

Devoluções

Um número assinado que indica os valores relativos desta instância e value.

Valor de retornoDescrição
Um inteiro negativoEsta instância é menor que value.
ZeroEsta instância é igual a value.
Um número inteiro positivoEsta instância é maior que value.

Implementações

Observações

Este membro é uma implementação explícita de membro de interface. Só pode ser usado quando a Guid instância é projetada para uma IComparable interface.

O CompareTo método compara os GUIDs como se fossem valores fornecidos ao Guid(Int32, Int16, Int16, Byte[]) construtor, da seguinte forma:

  • Compara os UInt32 valores e devolve um resultado se forem desiguais. Se forem iguais, faz a próxima comparação.
  • Compara os primeiros UInt16 valores e devolve um resultado se forem desiguais. Se forem iguais, faz a próxima comparação.
  • Compara os segundos UInt16 valores e devolve um resultado se forem desiguais. Se forem iguais, faz a próxima comparação.
  • Se realiza uma comparação byte a byte dos oito Byte valores seguintes. Quando encontra o primeiro par desigual, devolve o resultado. Caso contrário, devolve 0 para indicar que os dois Guid valores são iguais.

Note-se que os últimos oito bytes aparecem na representação da string de a Guid em ordem inversa, de byte baixo para byte alto. Por exemplo, na representação da cadeia do Guid valor "01e75c83-c6f5-4192-b57e-7427cec5560d", os últimos oito bytes são "b57e-7427cec5560d." Ou seja, os últimos oito bytes são comparados byte a byte, da esquerda para a direita, começando por 0xb5.

Se dois GUIDs tiverem valores iguais para um componente, o método compara o componente seguinte. Quando encontra um componente cujos valores são desiguais, devolve o resultado.

Este método implementa a System.IComparable<T> interface e tem um desempenho ligeiramente melhor do que o Guid.CompareTo método porque não precisa de converter o value parâmetro num Guid valor.

Aplica-se a