Guid.IComparable.CompareTo(Object) Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Vergleicht diese Instanz mit einem angegebenen Guid-Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.

 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

Parameter

value

Object

Ein mit dieser Instanz zu vergleichendes Objekt.

Gibt zurück

Int32

Eine Zahl mit Vorzeichen, die das Verhältnis zwischen dem Wert dieser Instanz und value angibt.

Rückgabewert	BESCHREIBUNG
Eine negative ganze Zahl	Diese Instanz ist kleiner als value.
Zero	Diese Instanz ist gleich value.
Eine positive ganze Zahl	Diese Instanz ist größer als value.

Implementiert

CompareTo(Object)

Hinweise

Bei diesem Member handelt es sich um eine explizite Schnittstellenmemberimplementierung. Sie kann nur verwendet werden, wenn die Guid Instanz in eine IComparable Schnittstelle gecastt wird.

Die CompareTo Methode vergleicht die GUIDs wie folgt, als ob sie Werte für den Guid(Int32, Int16, Int16, Byte[]) Konstruktor bereitgestellt wurden:

• Es vergleicht die UInt32 Werte und gibt ein Ergebnis zurück, wenn sie ungleich sind. Wenn sie gleich sind, führt sie den nächsten Vergleich aus.
• Es vergleicht die ersten UInt16 Werte und gibt ein Ergebnis zurück, wenn sie ungleich sind. Wenn sie gleich sind, führt sie den nächsten Vergleich aus.
• Es vergleicht die zweiten UInt16 Werte und gibt ein Ergebnis zurück, wenn sie ungleich sind. Wenn sie gleich sind, führt sie den nächsten Vergleich aus.
• Wenn ein Byte-by-Byte-Vergleich der nächsten acht Byte Werte ausgeführt wird. Wenn es auf das erste ungleiche Paar trifft, gibt es das Ergebnis zurück. Andernfalls wird 0 zurückgegeben, um anzugeben, dass die beiden Guid Werte gleich sind.

Beachten Sie, dass die letzten acht Bytes in der Zeichenfolgendarstellung einer Guid umgekehrten Reihenfolge angezeigt werden, von einem niedrigen Byte bis hin zu hohem Byte. Beispielsweise sind in der Zeichenfolgendarstellung des Guid Werts "01e75c83-c6f5-4192-b57e-7427cec5560d" die letzten acht Bytes "b57e-7427cec560d". Mit anderen Worten, die letzten acht Bytes werden auf einer Byte-by-Byte-Basis von links nach rechts verglichen, beginnend mit 0xb5.

Wenn zwei GUIDs gleich Werte für eine Komponente haben, vergleicht die Methode die nächste Komponente. Wenn eine Komponente gefunden wird, deren Werte ungleich sind, wird das Ergebnis zurückgegeben.

Diese Methode implementiert die Schnittstelle und führt etwas besser als die System.IComparable<T> Guid.CompareTo Methode aus, da der value Parameter nicht in einen Guid Wert konvertiert werden muss.