Guid.IComparable.CompareTo(Object) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

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ée	Description
Entier négatif	Cette instance est inférieure à value.
Zéro	Cette instance est égale à value.
Entier positif	Cette instance est supérieure à value.

Implémente

CompareTo(Object)

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.