Guid.IComparable.CompareTo(Object) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Porównuje to wystąpienie z określonym Guid obiektem i zwraca wskazanie ich wartości względnych.
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
Parametry
- value
- Object
Obiekt do porównania z tym wystąpieniem.
Zwraca
Liczba ze znakiem wskazująca względne wartości tego wystąpienia i value.
| Wartość zwracana | Opis |
|---|---|
| Ujemna liczba całkowita | To wystąpienie jest mniejsze niż value. |
| Zero | To wystąpienie jest równe value. |
| Dodatnia liczba całkowita | To wystąpienie jest większe niż value. |
Implementuje
Uwagi
Ten element członkowski jest jawną implementacją składową interfejsu. Można go używać tylko wtedy, gdy Guid wystąpienie jest rzutowanie do interfejsu IComparable .
Metoda CompareTo porównuje identyfikatory GUID tak, jakby zostały podane do konstruktora Guid(Int32, Int16, Int16, Byte[]) w następujący sposób:
- Porównuje UInt32 wartości i zwraca wynik, jeśli są one nierówne. Jeśli są równe, wykonuje następne porównanie.
- Porównuje pierwsze UInt16 wartości i zwraca wynik, jeśli są one nierówne. Jeśli są równe, wykonuje następne porównanie.
- Porównuje drugie UInt16 wartości i zwraca wynik, jeśli są one nierówne. Jeśli są równe, wykonuje następne porównanie.
- Jeśli wykonuje porównanie bajtów po bajtach z następnych ośmiu Byte wartości. Gdy napotka pierwszą nierówną parę, zwraca wynik. W przeciwnym razie zwraca wartość 0, aby wskazać, że dwie Guid wartości są równe.
Należy pamiętać, że ostatnie osiem bajtów jest wyświetlane w ciągu reprezentującym odwrotną Guid kolejność od niskiej bajtu do wysokiej bajtu. Na przykład w ciągu reprezentującym Guid wartość "01e75c83-c6f5-4192-b57e-7427cec560d", ostatnie osiem bajtów to "b57e-7427cec5560d". Innymi słowy, ostatnie osiem bajtów jest porównywane na podstawie bajtów bajtowych od lewej do prawej, począwszy od 0xb5.
Jeśli dwa identyfikatory GUID mają równe wartości dla składnika, metoda porównuje następny składnik. Gdy znajdzie składnik, którego wartości są nierówne, zwraca wynik.
Ta metoda implementuje System.IComparable<T> interfejs i działa nieco lepiej niż Guid.CompareTo metoda, ponieważ nie musi konwertować parametru value na Guid wartość.