IComparable<T> Arabirim

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Bir değer türünün veya sınıfın örneklerini sıralamak veya sıralamak için türe özgü bir karşılaştırma yöntemi oluşturmak için uyguladığı genelleştirilmiş bir karşılaştırma yöntemini tanımlar.

C#

public interface IComparable<in T>

Tür Parametreleri

T

Karşılaştıracak nesnenin türü.

Bu genel tür parametresi kontravaryanttır. Bu, kendi belirttiğiniz türü veya daha az türetilmiş başka bir türü kullanabileceğiniz anlamına gelir. Kovaryans ve kontravaryans hakkında daha fazla bilgi için bkz. Genel Türlerde Kovaryans ve Kontravaryans.

Türetilmiş

Microsoft.Extensions.DependencyInjection.Specification.Fakes.ClassImplementingIComparable

System.Boolean

System.Byte

System.Char

System.DateOnly

System.DateTime

System.DateTimeOffset

System.Decimal

System.Double

System.Guid

System.Half

System.Int128

System.Int16

System.Int32

System.Int64

System.IntPtr

System.IO.Log.SequenceNumber

System.Numerics.BigInteger

System.Numerics.IBinaryFloatingPointIeee754<TSelf>

System.Numerics.IBinaryInteger<TSelf>

System.Numerics.IBinaryNumber<TSelf>

System.Numerics.IFloatingPoint<TSelf>

System.Numerics.IFloatingPointIeee754<TSelf>

System.Numerics.INumber<TSelf>

System.Runtime.InteropServices.NFloat

System.SByte

System.Security.Principal.SecurityIdentifier

System.ServiceModel.Discovery.DiscoveryMessageSequence

System.Single

System.String

System.Text.Rune

System.TimeOnly

System.TimeSpan

System.UInt128

System.UInt16

System.UInt32

System.UInt64

System.UIntPtr

System.ValueTuple

System.ValueTuple<T1>

System.ValueTuple<T1,T2>

System.ValueTuple<T1,T2,T3>

System.ValueTuple<T1,T2,T3,T4>

System.ValueTuple<T1,T2,T3,T4,T5>

System.ValueTuple<T1,T2,T3,T4,T5,T6>

System.ValueTuple<T1,T2,T3,T4,T5,T6,T7>

System.ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>

System.Version

Örnekler

Aşağıdaki örnek, basit Temperature bir nesne için uygulamasını IComparable<T> göstermektedir. Örnek, nesne anahtarlarıyla Temperature bir SortedList<TKey,TValue> dize koleksiyonu oluşturur ve sıra dışı olarak listeye birkaç sıcaklık ve dize çifti ekler. yöntemi çağrısında AddSortedList<TKey,TValue> koleksiyon, daha sonra sıcaklığı artırmaya göre görüntülenen liste girdilerini sıralamak için uygulamasını kullanır IComparable<T> .

C#

using System;
using System.Collections.Generic;

public class Temperature : IComparable<Temperature>
{
    // Implement the generic CompareTo method with the Temperature
    // class as the Type parameter.
    //
    public int CompareTo(Temperature other)
    {
        // If other is not a valid object reference, this instance is greater.
        if (other == null) return 1;

        // The temperature comparison depends on the comparison of
        // the underlying Double values.
        return m_value.CompareTo(other.m_value);
    }

    // Define the is greater than operator.
    public static bool operator >  (Temperature operand1, Temperature operand2)
    {
       return operand1.CompareTo(operand2) > 0;
    }

    // Define the is less than operator.
    public static bool operator <  (Temperature operand1, Temperature operand2)
    {
       return operand1.CompareTo(operand2) < 0;
    }

    // Define the is greater than or equal to operator.
    public static bool operator >=  (Temperature operand1, Temperature operand2)
    {
       return operand1.CompareTo(operand2) >= 0;
    }

    // Define the is less than or equal to operator.
    public static bool operator <=  (Temperature operand1, Temperature operand2)
    {
       return operand1.CompareTo(operand2) <= 0;
    }

    // The underlying temperature value.
    protected double m_value = 0.0;

    public double Celsius
    {
        get
        {
            return m_value - 273.15;
        }
    }

    public double Kelvin
    {
        get
        {
            return m_value;
        }
        set
        {
            if (value < 0.0)
            {
                throw new ArgumentException("Temperature cannot be less than absolute zero.");
            }
            else
            {
                m_value = value;
            }
        }
    }

    public Temperature(double kelvins)
    {
        this.Kelvin = kelvins;
    }
}

public class Example
{
    public static void Main()
    {
        SortedList<Temperature, string> temps =
            new SortedList<Temperature, string>();

        // Add entries to the sorted list, out of order.
        temps.Add(new Temperature(2017.15), "Boiling point of Lead");
        temps.Add(new Temperature(0), "Absolute zero");
        temps.Add(new Temperature(273.15), "Freezing point of water");
        temps.Add(new Temperature(5100.15), "Boiling point of Carbon");
        temps.Add(new Temperature(373.15), "Boiling point of water");
        temps.Add(new Temperature(600.65), "Melting point of Lead");

        foreach( KeyValuePair<Temperature, string> kvp in temps )
        {
            Console.WriteLine("{0} is {1} degrees Celsius.", kvp.Value, kvp.Key.Celsius);
        }
    }
}
/* This example displays the following output:
      Absolute zero is -273.15 degrees Celsius.
      Freezing point of water is 0 degrees Celsius.
      Boiling point of water is 100 degrees Celsius.
      Melting point of Lead is 327.5 degrees Celsius.
      Boiling point of Lead is 1744 degrees Celsius.
      Boiling point of Carbon is 4827 degrees Celsius.
*/

Açıklamalar

Bu arabirim, değerleri sıralanabilir veya sıralanabilir türler tarafından uygulanır ve genel bir koleksiyon nesnesinin üyelerini sıralamak için kesin olarak belirlenmiş bir karşılaştırma yöntemi sağlar. Örneğin, bir sayı ikinci bir sayıdan büyük olabilir ve bir dize diğerinden önce alfabetik sırada görüntülenebilir. Türlerin uygulanmasının, CompareTo(T)geçerli örneğin sıralama düzenindeki konumunun önce mi, sonra mı yoksa aynı türde ikinci bir nesneyle aynı mı olduğunu belirten tek bir yöntemi tanımlamasını gerektirir. Genellikle, yöntem doğrudan geliştirici kodundan çağrılır. Bunun yerine, ve Addgibi yöntemler tarafından otomatik olarak List<T>.Sort() çağrılır.

Genellikle, bir IComparable<T> uygulama sağlayan türler de arabirimini IEquatable<T> uygular. IEquatable<T> arabirimi, uygulama türünün örneklerinin eşitliğini belirleyen yöntemini tanımlarEquals.

yönteminin CompareTo(T) uygulanması, aşağıdaki tabloda gösterildiği gibi üç değerden birine sahip bir Int32 döndürmelidir.

Değer	Anlamı
Sıfırdan küçük	Bu nesne, sıralama düzeninde CompareTo yöntemi tarafından belirtilen nesnenin önündedir.
Sıfır	Bu geçerli örnek, sıralama düzeninde yöntem bağımsız değişkeni tarafından belirtilen nesneyle CompareTo aynı konumda yer alır.
Sıfırdan büyük	Bu geçerli örnek, sıralama düzeninde CompareTo yöntem bağımsız değişkeni tarafından belirtilen nesneyi izler.

Tüm sayısal türler (ve gibi Int32Double) , , ve DateTimegibi CharStringuygularIComparable<T>. Özel türler ayrıca nesne örneklerinin IComparable<T> sıralanması veya sıralanması için kendi uygulamalarını sağlamalıdır.

Uygulayanlara Notlar

Arabirimin type parametresini IComparable<T> bu arabirimi uygulayan türle değiştirin.

uygularsanızIComparable<T>, ile CompareTo(T)tutarlı değerler döndürmek için , op_GreaterThanOrEqual, op_LessThanve op_LessThanOrEqual işleçlerini aşırı yüklemelisinizop_GreaterThan. Ayrıca uygulamanız gerekir IEquatable<T>. Tam bilgi için makaleye IEquatable<T> bakın.

Yöntemler

CompareTo(T)

Mevcut örneği aynı türdeki başka bir nesne ile karşılaştırır ve geçerli örneğin, diğer nesneyle aynı sıralama düzeni konumunda mı olduğunu, önünde mi olduğunu, yoksa arkasında mı olduğunu belirten bir tamsayı döndürür.

Şunlara uygulanır

Ayrıca bkz.

• IComparable
• IEquatable<T>