Guid.IComparable.CompareTo(Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> intFunction CompareTo (value As Object) As Integer Implements IComparable.CompareToParamètres
- value
- Object
Objet à comparer à cette instance.
Retours
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
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.