Guid.IComparable.CompareTo(Object) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 retorno | Descrição |
|---|---|
| Um inteiro negativo | Esta instância é menor que value. |
| Zero | Esta instância é igual a value. |
| Um número inteiro positivo | Esta 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.