Comparison<T> Temsilci

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

Aynı türdeki iki nesneyi karşılaştıran yöntemi temsil eder.

C#

public delegate int Comparison<in T>(T x, T y);

C#

public delegate int Comparison<T>(T x, T y);

Tür Parametreleri

T

Karşılaştıracak nesnelerin 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.

Parametreler

x

T

Karşılaştırma yapılacak ilk nesne.

y

T

Karşılaştırma yapılacak ikinci nesne.

Dönüş Değeri

Int32

Aşağıdaki tabloda gösterildiği gibi ve ygöreli değerlerini gösteren işaretli bir tamsayıx.

Değer	Anlamı
0'dan küçük	x değerinden küçüktür y.
0	x eşittir y.
0'dan büyük	x değerinden büyüktür y.

Örnekler

Aşağıdaki kod örneği, yöntem aşırı yüklemesiyle temsilcinin Comparison<T> Sort(Comparison<T>) kullanımını gösterir.

Kod örneği, dizeler için adlı CompareDinosByLengthalternatif bir karşılaştırma yöntemi tanımlar. Bu yöntem şu şekilde çalışır: İlk olarak, karşılaştırmalar için nulltest edilir ve null başvuru null olmayan bir başvurudan küçük olarak kabul edilir. İkincisi, dize uzunlukları karşılaştırılır ve uzun dize daha büyük olarak kabul edilir. Üçüncüsü, uzunluklar eşitse, normal dize karşılaştırması kullanılır.

Dizelerden List<T> biri oluşturulur ve belirli bir sırada dört dizeyle doldurulur. Liste ayrıca boş bir dize ve null başvuru içerir. Liste görüntülenir, yöntemi temsil eden CompareDinosByLength genel bir Comparison<T> temsilci kullanılarak sıralanır ve yeniden görüntülenir.

C#

using System;
using System.Collections.Generic;

public class Example
{
    private static int CompareDinosByLength(string x, string y)
    {
        if (x == null)
        {
            if (y == null)
            {
                // If x is null and y is null, they're
                // equal.
                return 0;
            }
            else
            {
                // If x is null and y is not null, y
                // is greater.
                return -1;
            }
        }
        else
        {
            // If x is not null...
            //
            if (y == null)
                // ...and y is null, x is greater.
            {
                return 1;
            }
            else
            {
                // ...and y is not null, compare the
                // lengths of the two strings.
                //
                int retval = x.Length.CompareTo(y.Length);

                if (retval != 0)
                {
                    // If the strings are not of equal length,
                    // the longer string is greater.
                    //
                    return retval;
                }
                else
                {
                    // If the strings are of equal length,
                    // sort them with ordinary string comparison.
                    //
                    return x.CompareTo(y);
                }
            }
        }
    }

    public static void Main()
    {
        List<string> dinosaurs = new List<string>();
        dinosaurs.Add("Pachycephalosaurus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("");
        dinosaurs.Add(null);
        dinosaurs.Add("Mamenchisaurus");
        dinosaurs.Add("Deinonychus");
        Display(dinosaurs);

        Console.WriteLine("\nSort with generic Comparison<string> delegate:");
        dinosaurs.Sort(CompareDinosByLength);
        Display(dinosaurs);
    }

    private static void Display(List<string> list)
    {
        Console.WriteLine();
        foreach( string s in list )
        {
            if (s == null)
                Console.WriteLine("(null)");
            else
                Console.WriteLine("\"{0}\"", s);
        }
    }
}

/* This code example produces the following output:

"Pachycephalosaurus"
"Amargasaurus"
""
(null)
"Mamenchisaurus"
"Deinonychus"

Sort with generic Comparison<string> delegate:

(null)
""
"Deinonychus"
"Amargasaurus"
"Mamenchisaurus"
"Pachycephalosaurus"
 */

Aşağıdaki örnek, bir nesne koleksiyonunun öğelerini sıralamak için temsilciyi CityInfo kullanırComparison<T>. CityInfo , bir şehir ve nüfusu hakkında bilgi içeren uygulama tanımlı bir sınıftır. Örnek, CompareByNamenesneleri sıralamanın CityInfo üç farklı yolunu sunan üç yöntem tanımlar: , CompareByPopulation, ve CompareByNames. Her yöntem yönteminin comparison bağımsız değişkenine Array.Sort<T>(T[], Comparison<T>) atanır.

C#

using System;

public class CityInfo
{
   string cityName;
   string countryName;
   int pop2010;

   public CityInfo(string name, string country, int pop2010)
   {
      this.cityName = name;
      this.countryName = country;
      this.pop2010 = pop2010;
   }

   public string City
   { get { return this.cityName; } }

   public string Country
   { get { return this.countryName; } }

   public int Population
   { get { return this.pop2010; } }

   public static int CompareByName(CityInfo city1, CityInfo city2)
   {
      return String.Compare(city1.City, city2.City);
   }

   public static int CompareByPopulation(CityInfo city1, CityInfo city2)
   {
      return city1.Population.CompareTo(city2.Population);
   }

   public static int CompareByNames(CityInfo city1, CityInfo city2)
   {
      return String.Compare(city1.Country + city1.City, city2.Country + city2.City);
   }
}

public class Example
{
   public static void Main()
   {
      CityInfo NYC = new CityInfo("New York City", "United States of America", 8175133 );
      CityInfo Det = new CityInfo("Detroit", "United States of America", 713777);
      CityInfo Paris = new CityInfo("Paris", "France",  2193031);
      CityInfo[] cities = { NYC, Det, Paris };
      // Display ordered array.
      DisplayArray(cities);

      // Sort array by city name.
      Array.Sort(cities, CityInfo.CompareByName);
      DisplayArray(cities);

      // Sort array by population.
      Array.Sort(cities, CityInfo.CompareByPopulation);
      DisplayArray(cities);

      // Sort array by country + city name.
      Array.Sort(cities, CityInfo.CompareByNames);
      DisplayArray(cities);
   }

   private static void DisplayArray(CityInfo[] cities)
   {
      Console.WriteLine("{0,-20} {1,-25} {2,10}", "City", "Country", "Population");
      foreach (var city in cities)
         Console.WriteLine("{0,-20} {1,-25} {2,10:N0}", city.City,
                           city.Country, city.Population);

      Console.WriteLine();
   }
}
// The example displays the following output:
//     City                 Country                   Population
//     New York City        United States of America   8,175,133
//     Detroit              United States of America     713,777
//     Paris                France                     2,193,031
//
//     City                 Country                   Population
//     Detroit              United States of America     713,777
//     New York City        United States of America   8,175,133
//     Paris                France                     2,193,031
//
//     City                 Country                   Population
//     Detroit              United States of America     713,777
//     Paris                France                     2,193,031
//     New York City        United States of America   8,175,133
//
//     City                 Country                   Population
//     Paris                France                     2,193,031
//     Detroit              United States of America     713,777
//     New York City        United States of America   8,175,133

Açıklamalar

Bu temsilci, bir dizi veya listenin Array öğelerini sıralamak için sınıfının yöntem aşırı yüklemesi ve Sort(Comparison<T>) sınıfın yöntem aşırı yüklemesi List<T> tarafından Sort<T>(T[], Comparison<T>) kullanılır.

Uzantı Metotları

GetMethodInfo(Delegate)

Belirtilen temsilci tarafından temsil edilen yöntemi temsil eden bir nesnesi alır.

Şunlara uygulanır

Ayrıca bkz.

• Sort<T>(T[], Comparison<T>)
• Sort(Comparison<T>)