Partager via


Guid.IComparable.CompareTo(Object) Méthode

Définition

Compare cette instance à un objet Guid spécifié et retourne une indication de leurs valeurs relatives.

 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

Paramètres

value
Object

Objet à comparer à cette instance.

Retours

Int32

Nombre signé indiquant les valeurs relatives de cette instance et value.

Valeur retournéeDescription
Entier négatifCette instance est inférieure à value.
ZéroCette instance est égale à value.
Entier positifCette instance est supérieure à value.

Implémente

Remarques

Ce membre est une implémentation d'un membre d'interface explicite. Elle ne peut être utilisée que lorsque l’instance Guid est convertie en IComparable interface.

La CompareTo méthode compare les GUID comme s’ils étaient des valeurs fournies au Guid(Int32, Int16, Int16, Byte[]) constructeur, comme suit :

  • Il compare les UInt32 valeurs et retourne un résultat s’ils sont inégaux. S’ils sont égaux, il effectue la comparaison suivante.
  • Il compare les premières UInt16 valeurs et retourne un résultat s’ils sont inégaux. S’ils sont égaux, il effectue la comparaison suivante.
  • Il compare les deuxièmes UInt16 valeurs et retourne un résultat s’ils sont inégaux. S’ils sont égaux, il effectue la comparaison suivante.
  • Si vous effectuez une comparaison d’octets par octets des huit Byte valeurs suivantes. Lorsqu’elle rencontre la première paire inégale, elle retourne le résultat. Sinon, elle retourne 0 pour indiquer que les deux Guid valeurs sont égales.

Notez que les huit derniers octets apparaissent dans la représentation sous forme de chaîne d’un Guid ordre inverse, de bas octets à octets élevés. Par exemple, dans la représentation sous forme de chaîne de la Guid valeur « 01e75c83-c6f5-4192-b57e-7427cec5560d », les huit derniers octets sont « b57e-7427cec5560d ». En d’autres termes, les huit derniers octets sont comparés sur une base d’octets de gauche à droite à partir de 0xb5.

Si deux GUID ont des valeurs égales pour un composant, la méthode compare le composant suivant. Lorsqu’il trouve un composant dont les valeurs sont inégales, il retourne le résultat.

Cette méthode implémente l’interface System.IComparable<T> et effectue légèrement mieux que la Guid.CompareTo méthode, car elle n’a pas à convertir le value paramètre en Guid valeur.

S’applique à