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
Объект, сравниваемый с этим экземпляром.
Возвращаемое значение
Число со знаком, представляющее относительные значения этого экземпляра и параметра 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 значение.