Guid.CompareTo Yöntem

Başvuru

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bu örneği belirtilen bir nesneyle karşılaştırır veya Guid göreli değerlerinin bir göstergesini döndürür.

Aşırı Yüklemeler

CompareTo(Guid)	Bu örneği belirtilen Guid bir nesneyle karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.
CompareTo(Object)	Bu örneği belirtilen nesne ile karşılaştırır ve göreli değerlerin bir göstergesini döndürür.

CompareTo(Guid)

Kaynak:: Guid.cs

Kaynak:: Guid.cs

Kaynak:: Guid.cs

Bu örneği belirtilen Guid bir nesneyle karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.

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

Parametreler

value: Guid

Bu örnekle karşılaştırılacak bir nesne.

Döndürülenler

Int32

Bu örneğin ve valuedeğerlerini gösteren imzalı bir sayı.

Döndürülen değer	Açıklama
Negatif bir tamsayı	Bu örnek değerinden `value`küçük.
Sıfır	Bu örnek eşittir `value`.
Pozitif bir tamsayı	Bu örnek değerinden `value`büyüktür.

Uygulamalar

CompareTo(T)

Örnekler

Aşağıdaki örnek, bir GUID değerini benzer iki GUID değeriyle karşılaştırmak için yöntemini çağırır CompareTo(Guid) .

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

Açıklamalar

yöntemi GUID'leri CompareTo oluşturucuya Guid(Int32, Int16, Int16, Byte[]) sağlanan değerler gibi aşağıdaki gibi karşılaştırır:

Değerleri karşılaştırır UInt32 ve eşit olmayan bir sonuç döndürür. Eşitse, bir sonraki karşılaştırmayı gerçekleştirir.
İlk UInt16 değerleri karşılaştırır ve eşit olmayan bir sonuç döndürür. Eşitse, bir sonraki karşılaştırmayı gerçekleştirir.
İkinci UInt16 değerleri karşılaştırır ve eşit olmayan bir sonuç döndürür. Eşitse, bir sonraki karşılaştırmayı gerçekleştirir.
Sonraki sekiz Byte değerin bayt bayt karşılaştırmasını gerçekleştirirse. İlk eşit olmayan çiftle karşılaştığında sonucu döndürür. Aksi takdirde, iki Guid değerin eşit olduğunu belirtmek için 0 döndürür.

Son sekiz bayt değerinin, düşük bayttan yüksek bayta kadar ters sırada dize Guid gösteriminde göründüğünü unutmayın. Örneğin, "01e75c83-c6f5-4192-b57e-7427cec5560d" değerinin dize gösteriminde Guid , son sekiz bayt "b57e-7427cec5560d" şeklindedir. Başka bir deyişle, son sekiz bayt, 0xb5 ile başlayarak soldan sağa bayt bazında karşılaştırılır.

İki GUID bir bileşen için eşit değerlere sahipse, yöntemi bir sonraki bileşeni karşılaştırır. Değerleri eşit olmayan bir bileşen bulduğunda, sonucu döndürür.

Bu yöntem arabirimini uygular ve parametresini System.IComparable<T> bir değere dönüştürmesi gerekmediğinden yönteminden Guid.CompareTovalue biraz daha iyi performans Guid gösterir.

Şunlara uygulanır

CompareTo(Object)

Kaynak:: Guid.cs

Kaynak:: Guid.cs

Kaynak:: Guid.cs

Bu örneği belirtilen nesne ile karşılaştırır ve göreli değerlerin bir göstergesini döndürür.

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

Parametreler

value: Object

Karşılaştıracak bir nesne veya null.

Döndürülenler

Int32

Bu örneğin ve valuedeğerlerini gösteren imzalı bir sayı.

Döndürülen değer	Açıklama
Negatif bir tamsayı	Bu örnek değerinden `value`küçük.
Sıfır	Bu örnek eşittir `value`.
Pozitif bir tamsayı	Bu örnek veya `valuenull`değerinden `value`büyüktür.

Uygulamalar

CompareTo(Object)

Özel durumlar

ArgumentException

value bir Guiddeğildir.

Örnekler

Aşağıdaki örnek, bir sınıfa GuidAttribute GUID atamak için özniteliğini kullanır. Yöntemini çağırarak Attribute.GetCustomAttribute ve döndürülen GuidAttribute nesnenin özelliğini yöntemine Parse geçirerek Value bu GUID değerini alır. Ardından guid değerini bir değer dizisiyle karşılaştırır.

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

Açıklamalar

value parametresi veya örneği Guidolmalıdırnull; aksi takdirde bir özel durum oluşturulur. değerinden Guidbağımsız olarak herhangi bir örneği değerinden büyük nullolarak kabul edilir.

yöntemi GUID'leri CompareTo oluşturucuya Guid sağlanan değerler gibi aşağıdaki gibi karşılaştırır:

Değerleri karşılaştırır Int32 ve eşit olmayan bir sonuç döndürür. Eşitse, bir sonraki karşılaştırmayı gerçekleştirir.
İlk Int16 değerleri karşılaştırır ve eşit olmayan bir sonuç döndürür. Eşitse, bir sonraki karşılaştırmayı gerçekleştirir.
İkinci Int16 değerleri karşılaştırır ve eşit olmayan bir sonuç döndürür. Eşitse, bir sonraki karşılaştırmayı gerçekleştirir.
Sonraki sekiz Byte değerin bayt bayt karşılaştırmasını gerçekleştirirse. İlk eşit olmayan çiftle karşılaştığında sonucu döndürür. Aksi takdirde, iki Guid değerin eşit olduğunu belirtmek için 0 döndürür.

İki GUID bir bileşen için eşit değerlere sahipse, yöntemi bir sonraki bileşeni karşılaştırır. Değerleri eşit olmayan bir bileşen bulduğunda, sonucu döndürür.

Şunlara uygulanır

Guid.CompareTo Yöntem

Tanım

Aşırı Yüklemeler

CompareTo(Guid)

Parametreler

Döndürülenler

Uygulamalar

Örnekler

Açıklamalar

Şunlara uygulanır

CompareTo(Object)

Parametreler

Döndürülenler

Uygulamalar

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar