Guid.IComparable.CompareTo(Object) Метод

Определение

Сравнивает этот экземпляр с заданным объектом Guid и возвращает значение, указывающее, как соотносятся значения этих объектов.

 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

Параметры

value
Object

Объект, сравниваемый с этим экземпляром.

Возвращаемое значение

Int32

Число со знаком, представляющее относительные значения этого экземпляра и параметра value.

Возвращаемое значениеОписание
Отрицательное целое числоЭтот экземпляр меньше параметра value.
НульЭтот экземпляр и параметр value равны.
Положительное целое числоЭтот экземпляр больше параметра value.

Реализации

Комментарии

Этот член представляет собой явную реализацию члена интерфейса. Его можно использовать только при Guid приведении экземпляра к IComparable интерфейсу.

CompareToМетод сравнивает идентификаторы GUID, как если бы они были значениями, предоставленными Guid(Int32, Int16, Int16, Byte[]) конструктору, следующим образом:

  • Он сравнивает UInt32 значения и возвращает результат, если они не равны. Если они равны, выполняется следующее сравнение.
  • Он сравнивает первые UInt16 значения и возвращает результат, если они не равны. Если они равны, выполняется следующее сравнение.
  • Он сравнивает значения второго типа UInt16 и возвращает результат, если они не равны. Если они равны, выполняется следующее сравнение.
  • Если выполняет побайтовое сравнение следующих восьми Byte значений. При обнаружении первой неравной пары она возвращает результат. В противном случае он возвращает 0, чтобы указать, что два Guid значения равны.

Обратите внимание, что последние восемь байт отображаются в строковом представлении в Guid обратном порядке, от младшего байта до старших байт. Например, в строковом представлении Guid значения «01e75c83-c6f5-4192-b57e-7427cec5560d» конечные восемь байт имеют значение «b57e-7427cec5560d». Иными словами, последние восемь байтов сравниваются по побайтовой основе слева направо, начиная с 0xb5.

Если два идентификатора GUID имеют равные значения для компонента, метод сравнивает следующий компонент. При обнаружении компонента, значения которого не равны, возвращается результат.

Этот метод реализует System.IComparable<T> интерфейс и работает немного лучше, чем Guid.CompareTo метод, поскольку ему не нужно преобразовывать value параметр в Guid значение.

Применяется к