Guid.CompareTo Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Confronta l'istanza con un oggetto specificato o un oggetto Guid e restituisce un'indicazione dei relativi valori.

Overload

CompareTo(Guid)

Confronta questa istanza con un oggetto Guid specificato e restituisce un'indicazione dei valori relativi.
CompareTo(Object)

Confronta questa istanza con un oggetto specificato e restituisce un'indicazione dei valori relativi.

CompareTo(Guid)

Confronta questa istanza con un oggetto Guid specificato e restituisce un'indicazione dei valori relativi.

public:
 virtual int CompareTo(Guid value);
public int CompareTo (Guid value);
abstract member CompareTo : Guid -> int
override this.CompareTo : Guid -> int
Public Function CompareTo (value As Guid) As Integer

Parametri

value
Guid

Oggetto da confrontare con questa istanza.

Restituisce

Int32

Numero con segno che indica i valori relativi di questa istanza e di value.

Valore restituito Descrizione
Intero negativo L'istanza è minore di value.
Zero L'istanza è uguale a value.
Intero positivo L'istanza è maggiore di value.

Implementazioni

CompareTo(T)

Esempio

Nell'esempio seguente viene chiamato il CompareTo(Guid) metodo per confrontare un valore GUID con due valori GUID simili.

using System;

public class Example
{
   public static void Main()
   {
      Guid mainGuid = Guid.Parse("01e75c83-c6f5-4192-b57e-7427cec5560d");
      unchecked {
         Guid guid2 = new Guid(0x01e75c83, (short) 0xc6f5,
                               0x4192,
                               new Byte[] { 0xb5, 0x7e, 0x74, 0x27, 0xce, 0xc5, 0x56, 0x0c} );
         Guid guid3 = Guid.Parse("01e75c84-c6f5-4192-b57e-7427cec5560d");

         Console.WriteLine("{0} {1:F} {2}", mainGuid,
                           (Comparison) mainGuid.CompareTo(guid2), guid2);
         Console.WriteLine("{0} {1:F} {2}", mainGuid,
                           (Comparison) mainGuid.CompareTo(guid3), guid3);
      }
   }

   private enum Comparison
   { LessThan = -1, Equals = 0, GreaterThan = 1 }
}
// The example displays the following output:
//    01e75c83-c6f5-4192-b57e-7427cec5560d GreaterThan 01e75c83-c6f5-4192-b57e-7427cec5560c
//    01e75c83-c6f5-4192-b57e-7427cec5560d LessThan 01e75c84-c6f5-4192-b57e-7427cec5560d

open System

type Comparison =
    | ``Less Than`` = -1
    | Equals = 0
    | ``Greater Than`` = 1

let mainGuid = 
    Guid.Parse "01e75c83-c6f5-4192-b57e-7427cec5560d"

let guid2 = Guid(0x01e75c83, 0xc6f5s, 0x4192s, [| 0xb5uy; 0x7euy; 0x74uy; 0x27uy; 0xceuy; 0xc5uy; 0x56uy; 0x0cuy |])
let guid3 = 
    Guid.Parse("01e75c84-c6f5-4192-b57e-7427cec5560d")

printfn $"{mainGuid} {mainGuid.CompareTo guid2 |> enum<Comparison> :F} {guid2}"
printfn $"{mainGuid} {mainGuid.CompareTo guid3 |> enum<Comparison> :F} {guid3}"

// The example displays the following output:
//    01e75c83-c6f5-4192-b57e-7427cec5560d Greater Than 01e75c83-c6f5-4192-b57e-7427cec5560c
//    01e75c83-c6f5-4192-b57e-7427cec5560d Less Than 01e75c84-c6f5-4192-b57e-7427cec5560d

Module Example
   Public Sub Main()
      Dim mainGuid As Guid = Guid.Parse("01e75c83-c6f5-4192-b57e-7427cec5560d")
      Dim guid2 As New Guid(&h01e75c83, 
                            BitConverter.ToInt16(new Byte() { &hf5, &hc6 }, 0), 
                            &h4192, 
                            new Byte() { &hb5, &h7e, &h74, &h27, &hce, &hc5, &h56, &h0c} )
      Dim guid3 As Guid = Guid.Parse("01e75c84-c6f5-4192-b57e-7427cec5560d")
      
      Console.WriteLine("{0} {1:F} {2}", mainGuid, 
                        CType(mainGuid.CompareTo(guid2), Comparison), guid2)
      Console.WriteLine("{0} {1:F} {2}", mainGuid, 
                        CType(mainGuid.CompareTo(guid3), Comparison), guid3)
   End Sub
   
   Private Enum Comparison As Integer
      LessThan = -1
      Equals = 0
      GreaterThan = 1
   End Enum
End Module
' The example displays the following output:
'    01e75c83-c6f5-4192-b57e-7427cec5560d GreaterThan 01e75c83-c6f5-4192-b57e-7427cec5560c
'    01e75c83-c6f5-4192-b57e-7427cec5560d LessThan 01e75c84-c6f5-4192-b57e-7427cec5560d

Commenti

Il CompareTo metodo confronta i GUID come se fossero valori forniti al Guid(Int32, Int16, Int16, Byte[]) costruttore, come indicato di seguito:

  • Confronta i UInt32 valori e restituisce un risultato se non sono uguali. Se sono uguali, esegue il confronto successivo.

  • Confronta i primi UInt16 valori e restituisce un risultato se sono uguali. Se sono uguali, esegue il confronto successivo.

  • Confronta i secondi UInt16 valori e restituisce un risultato se non sono uguali. Se sono uguali, esegue il confronto successivo.

  • Se esegue un confronto di byte per byte dei valori successivi otto Byte . Quando incontra la prima coppia non uguale, restituisce il risultato. In caso contrario, restituisce 0 per indicare che i due Guid valori sono uguali.

Si noti che gli otto byte finali vengono visualizzati nella rappresentazione stringa di un Guid oggetto in ordine inverso, da byte basso a byte elevato. Ad esempio, nella rappresentazione stringa del Guid valore "01e75c83-c6f5-4192-b57e-7427cec5560d", gli otto byte finali sono "b57e-7427cec5560d". In altre parole, gli ultimi otto byte vengono confrontati in base a byte da sinistra a destra a partire da 0xb5.

Se due GUID hanno valori uguali per un componente, il metodo confronta il componente successivo. Quando trova un componente i cui valori sono uguali, restituisce il risultato.

Questo metodo implementa l'interfaccia System.IComparable<T> ed esegue leggermente meglio del Guid.CompareTo metodo perché non deve convertire il value parametro in un Guid valore.

Si applica a

CompareTo(Object)

Confronta questa istanza con un oggetto specificato e restituisce un'indicazione dei valori relativi.

public:
 virtual int CompareTo(System::Object ^ value);
public int CompareTo (object? value);
public int CompareTo (object value);
abstract member CompareTo : obj -> int
override this.CompareTo : obj -> int
Public Function CompareTo (value As Object) As Integer

Parametri

value
Object

Oggetto da confrontare o null.

Restituisce

Int32

Numero con segno che indica i valori relativi di questa istanza e di value.

Valore restituito Descrizione
Intero negativo L'istanza è minore di value.
Zero L'istanza è uguale a value.
Intero positivo L'istanza è maggiore di value oppure value è null.

Implementazioni

CompareTo(Object)

Eccezioni

ArgumentException

value non è un oggetto Guid.

Esempio

Nell'esempio seguente viene usato l'attributo GuidAttribute per assegnare un GUID a una classe. Recupera il valore di questo GUID chiamando il Attribute.GetCustomAttribute metodo e passando la Value proprietà dell'oggetto restituito GuidAttribute al Parse metodo . Confronta quindi il GUID con una matrice di valori.

using System;
using System.Runtime.InteropServices;

[Guid("936DA01F-9ABD-4d9d-80C7-02AF85C822A8")]
public class Example
{
   public static void Main()
   {
      GuidAttribute guidAttr = (GuidAttribute) Attribute.GetCustomAttribute(typeof(Example),
                                                      typeof(GuidAttribute));
      Guid guidValue = Guid.Parse(guidAttr.Value);
      Object[] values = { null , 16,
                          Guid.Parse("01e75c83-c6f5-4192-b57e-7427cec5560d"),
                          guidValue };
      foreach (var value in values) {
         try {
            Console.WriteLine("{0} and {1}: {2}", guidValue,
                              value == null ? "null" : value,
                              guidValue.CompareTo(value));
         }
         catch (ArgumentException) {
            Console.WriteLine("Cannot compare {0} and {1}", guidValue,
                              value == null ? "null" : value);
         }
      }
   }
}
// The example displays the following output:
//    936da01f-9abd-4d9d-80c7-02af85c822a8 and null: 1
//    Cannot compare 936da01f-9abd-4d9d-80c7-02af85c822a8 and 16
//    936da01f-9abd-4d9d-80c7-02af85c822a8 and 01e75c83-c6f5-4192-b57e-7427cec5560d: 1
//    936da01f-9abd-4d9d-80c7-02af85c822a8 and 936da01f-9abd-4d9d-80c7-02af85c822a8: 0

open System
open System.Runtime.InteropServices

[<Guid("936DA01F-9ABD-4d9d-80C7-02AF85C822A8")>]
type Example = class end

let guidAttr = 
    Attribute.GetCustomAttribute(typeof<Example>, typeof<GuidAttribute>) :?> GuidAttribute
    
let guidValue = 
    Guid.Parse guidAttr.Value

let values: obj[] =
    [| null; 16 
       Guid.Parse "01e75c83-c6f5-4192-b57e-7427cec5560d"
       guidValue |]

for value in values do
    try
        printfn $"{guidValue} and %A{value}: {guidValue.CompareTo value}"
    with :? ArgumentException ->
        printfn $"Cannot compare {guidValue} and %A{value}"

// The example displays the following output:
//    936da01f-9abd-4d9d-80c7-02af85c822a8 and <null>: 1
//    Cannot compare 936da01f-9abd-4d9d-80c7-02af85c822a8 and 16
//    936da01f-9abd-4d9d-80c7-02af85c822a8 and 01e75c83-c6f5-4192-b57e-7427cec5560d: 1
//    936da01f-9abd-4d9d-80c7-02af85c822a8 and 936da01f-9abd-4d9d-80c7-02af85c822a8: 0

Imports System.Runtime.InteropServices

<Guid("936DA01F-9ABD-4d9d-80C7-02AF85C822A8")>
Module Example
   Public Sub Main()
      Dim guidAttr As GuidAttribute = CType(Attribute.GetCustomAttribute(GetType(Example), 
                                                      GetType(GuidAttribute)), GuidAttribute)
      Dim guidValue As Guid = Guid.Parse(guidAttr.Value)
      Dim values() As Object = { Nothing, 16, 
                               Guid.Parse("01e75c83-c6f5-4192-b57e-7427cec5560d"),
                               guidValue }
      For Each value In values
         Try
            Console.WriteLine("{0} and {1}: {2}", guidValue, 
                              If(value Is Nothing, "null", value),
                              guidValue.CompareTo(value))
         Catch e As ArgumentException
            Console.WriteLine("Cannot compare {0} and {1}", guidValue,
                              If(value Is Nothing, "null", value))
         End Try                     
      Next                         
   End Sub
End Module
' The example displays the following output:
'    936da01f-9abd-4d9d-80c7-02af85c822a8 and null: 1
'    Cannot compare 936da01f-9abd-4d9d-80c7-02af85c822a8 and 16
'    936da01f-9abd-4d9d-80c7-02af85c822a8 and 01e75c83-c6f5-4192-b57e-7427cec5560d: 1
'    936da01f-9abd-4d9d-80c7-02af85c822a8 and 936da01f-9abd-4d9d-80c7-02af85c822a8: 0

Commenti

Il parametro deve essere null o un'istanza value di Guid; in caso contrario, viene generata un'eccezione. Qualsiasi istanza di Guid, indipendentemente dal relativo valore, viene considerata maggiore di null.

Il CompareTo metodo confronta i GUID come se fossero valori forniti al Guid costruttore, come indicato di seguito:

  • Confronta i Int32 valori e restituisce un risultato se non sono uguali. Se sono uguali, esegue il confronto successivo.

  • Confronta i primi Int16 valori e restituisce un risultato se sono uguali. Se sono uguali, esegue il confronto successivo.

  • Confronta i secondi Int16 valori e restituisce un risultato se non sono uguali. Se sono uguali, esegue il confronto successivo.

  • Se esegue un confronto di byte per byte dei valori successivi otto Byte . Quando incontra la prima coppia non uguale, restituisce il risultato. In caso contrario, restituisce 0 per indicare che i due Guid valori sono uguali.

Se due GUID hanno valori uguali per un componente, il metodo confronta il componente successivo. Quando trova un componente i cui valori sono uguali, restituisce il risultato.

Si noti che gli otto byte finali vengono visualizzati nella rappresentazione stringa di un Guid oggetto in ordine inverso, da byte basso a byte elevato. Ad esempio, nella rappresentazione stringa del Guid valore "01e75c83-c6f5-4192-b57e-7427cec5560d", gli otto byte finali sono "b57e-7427cec5560d".

Si applica a