IStructuralComparable Interfész

Definíció

Névtér:

System.Collections

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

IStructuralComparable.cs

Támogatja a gyűjteményobjektumok szerkezeti összehasonlítását.

public interface class IStructuralComparable

public interface IStructuralComparable

type IStructuralComparable = interface

Public Interface IStructuralComparable

Származtatott

System.Array

System.Collections.Immutable.ImmutableArray<T>

System.Tuple<T1>

System.Tuple<T1,T2>

System.Tuple<T1,T2,T3>

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

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

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

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

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

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>

Példák

Az alábbi példa egy objektumtömböt Tuple<T1,T2,T3,T4,T5,T6> hoz létre, amely három amerikai város népességadatait tartalmazza 1960 és 2000 között. A sextuple első összetevője a város neve. A fennmaradó öt összetevő 1960 és 2000 között tízéves időközönként képviseli a populációt.

Az PopulationComparer osztály olyan IComparer implementációt biztosít, amely lehetővé teszi, hogy a sextuples tömbjét annak bármely összetevője rendezze. A konstruktorban két érték van megadva az PopulationComparer osztály számára: a rendezési sorrendet meghatározó összetevő helyzete, valamint egy logikai érték, amely jelzi, hogy a rekordobjektumokat növekvő vagy csökkenő sorrendbe kell-e rendezni.

A példa ezután rendezetlen sorrendben jeleníti meg a tömb elemeit, a harmadik összetevő (1970-ben a sokaság) szerint rendezi őket, majd a hatodik összetevő (2000-ben a sokaság) szerint rendezi őket, és megjeleníti őket. Vegye figyelembe, hogy a példa nem hívja meg közvetlenül a metódust CompareTo . A metódust implicit módon hívja meg a metódus a Sort(Array, IComparer) tömb minden egyes rekordobjektumához.

using System;
using System.Collections;
using System.Collections.Generic;

public class PopulationComparer<T1, T2, T3, T4, T5, T6> : IComparer
{
   private int itemPosition;
   private int multiplier = -1;

   public PopulationComparer(int component) : this(component, true)
   { }

   public PopulationComparer(int component, bool descending)
   {
      if (!descending) multiplier = 1;

      if (component <= 0 || component > 6)
         throw new ArgumentException("The component argument is out of range.");

      itemPosition = component;
   }

   public int Compare(object x, object y)
   {
      var tX = x as Tuple<T1, T2, T3, T4, T5, T6>;
      if (tX == null)
      {
         return 0;
      }
      else
      {
         var tY = y as Tuple<T1, T2, T3, T4, T5, T6>;
         switch (itemPosition)
         {
            case 1:
               return Comparer<T1>.Default.Compare(tX.Item1, tY.Item1) * multiplier;
            case 2:
               return Comparer<T2>.Default.Compare(tX.Item2, tY.Item2) * multiplier;
            case 3:
               return Comparer<T3>.Default.Compare(tX.Item3, tY.Item3) * multiplier;
            case 4:
               return Comparer<T4>.Default.Compare(tX.Item4, tY.Item4) * multiplier;
            case 5:
               return Comparer<T5>.Default.Compare(tX.Item5, tY.Item5) * multiplier;
            case 6:
               return Comparer<T6>.Default.Compare(tX.Item6, tY.Item6) * multiplier;
            default:
               return Comparer<T1>.Default.Compare(tX.Item1, tY.Item1) * multiplier;
         }
      }
   }
}

public class Example
{
   public static void Main()
   {
      // Create array of sextuple with population data for three U.S.
      // cities, 1960-2000.
      Tuple<string, int, int, int, int, int>[] cities =
           { Tuple.Create("Los Angeles", 2479015, 2816061, 2966850, 3485398, 3694820),
             Tuple.Create("New York", 7781984, 7894862, 7071639, 7322564, 8008278),
             Tuple.Create("Chicago", 3550904, 3366957, 3005072, 2783726, 2896016) };

      // Display array in unsorted order.
      Console.WriteLine("In unsorted order:");
      foreach (var city in cities)
         Console.WriteLine(city.ToString());
      Console.WriteLine();

      Array.Sort(cities, new PopulationComparer<string, int, int, int, int, int>(3));

      // Display array in sorted order.
      Console.WriteLine("Sorted by population in 1970:");
      foreach (var city in cities)
         Console.WriteLine(city.ToString());
      Console.WriteLine();

      Array.Sort(cities, new PopulationComparer<string, int, int, int, int, int>(6));

      // Display array in sorted order.
      Console.WriteLine("Sorted by population in 2000:");
      foreach (var city in cities)
         Console.WriteLine(city.ToString());
   }
}
// The example displays the following output:
//    In unsorted order:
//    (Los Angeles, 2479015, 2816061, 2966850, 3485398, 3694820)
//    (New York, 7781984, 7894862, 7071639, 7322564, 8008278)
//    (Chicago, 3550904, 3366957, 3005072, 2783726, 2896016)
//    
//    Sorted by population in 1970:
//    (New York, 7781984, 7894862, 7071639, 7322564, 8008278)
//    (Chicago, 3550904, 3366957, 3005072, 2783726, 2896016)
//    (Los Angeles, 2479015, 2816061, 2966850, 3485398, 3694820)
//    
//    Sorted by population in 2000:
//    (New York, 7781984, 7894862, 7071639, 7322564, 8008278)
//    (Los Angeles, 2479015, 2816061, 2966850, 3485398, 3694820)
//    (Chicago, 3550904, 3366957, 3005072, 2783726, 2896016)

Imports System.Collections
Imports System.Collections.Generic

Public Class PopulationComparer(Of T1, T2, T3, T4, T5, T6) : Implements IComparer
   Private itemPosition As Integer
   Private multiplier As Integer = -1
      
   Public Sub New(component As Integer)
      Me.New(component, True)
   End Sub
   
   Public Sub New(component As Integer, descending As Boolean)
      If Not descending Then multiplier = 1
      
      If component <= 0 Or component > 6 Then 
         Throw New ArgumentException("The component argument is out of range.")
      End If
      itemPosition = component
   End Sub 
   
   Public Function Compare(x As Object, y As Object) As Integer _
                   Implements IComparer.Compare
 
      Dim tX = TryCast(x, Tuple(Of T1, T2, T3, T4, T5, T6))
      If tX Is Nothing Then
         Return 0
      Else
         Dim tY = DirectCast(y, Tuple(Of T1, T2, T3, T4, T5, T6))
         Select Case itemPosition
            Case 1
               Return Comparer(Of T1).Default.Compare(tX.Item1, tY.Item1) * multiplier
            Case 2
               Return Comparer(Of T2).Default.Compare(tX.Item2, tY.Item2) * multiplier
            Case 3
               Return Comparer(Of T3).Default.Compare(tX.Item3, tY.Item3) * multiplier
            Case 4
               Return Comparer(Of T4).Default.Compare(tX.Item4, tY.Item4) * multiplier
            Case 5
               Return Comparer(Of T5).Default.Compare(tX.Item5, tY.Item5) * multiplier
            Case 6
               Return Comparer(Of T6).Default.Compare(tX.Item6, tY.Item6) * multiplier
            ' This should never happen.
            Case Else
               Return 0
         End Select      
      End If
   End Function
End Class

Module Example
   Public Sub Main()
      ' Create array of sextuple with population data for three U.S. 
      ' cities, 1960-2000.
      Dim cities() = 
          { Tuple.Create("Los Angeles", 2479015, 2816061, 2966850, 3485398, 3694820),
            Tuple.Create("New York", 7781984, 7894862, 7071639, 7322564, 8008278),  
            Tuple.Create("Chicago", 3550904, 3366957, 3005072, 2783726, 2896016) } 
      
      ' Display array in unsorted order.
      Console.WriteLine("In unsorted order:")
      For Each city In cities
         Console.WriteLine(city.ToString())
      Next
      Console.WriteLine()
      
      Array.Sort(cities, New PopulationComparer(Of String, Integer, Integer, Integer, Integer, Integer)(3)) 
                           
      ' Display array in sorted order.
      Console.WriteLine("Sorted by population in 1970:")
      For Each city In cities
         Console.WriteLine(city.ToString())
      Next
      Console.WriteLine()
      
      Array.Sort(cities, New PopulationComparer(Of String, Integer, Integer, Integer, Integer, Integer)(6))
                           
      ' Display array in sorted order.
      Console.WriteLine("Sorted by population in 2000:")
      For Each city In cities
         Console.WriteLine(city.ToString())
      Next
   End Sub
End Module
' The example displays the following output:
'    In unsorted order:
'    (Los Angeles, 2479015, 2816061, 2966850, 3485398, 3694820)
'    (New York, 7781984, 7894862, 7071639, 7322564, 8008278)
'    (Chicago, 3550904, 3366957, 3005072, 2783726, 2896016)
'    
'    Sorted by population in 1970:
'    (New York, 7781984, 7894862, 7071639, 7322564, 8008278)
'    (Chicago, 3550904, 3366957, 3005072, 2783726, 2896016)
'    (Los Angeles, 2479015, 2816061, 2966850, 3485398, 3694820)
'    
'    Sorted by population in 2000:
'    (New York, 7781984, 7894862, 7071639, 7322564, 8008278)
'    (Los Angeles, 2479015, 2816061, 2966850, 3485398, 3694820)
'    (Chicago, 3550904, 3366957, 3005072, 2783726, 2896016)

Megjegyzések

Az IStructuralComparable interfész lehetővé teszi, hogy testre szabott összehasonlításokat implementáljon a gyűjteménytagok számára. Ez azt jelenti, hogy pontosan megadhatja, hogy mit jelent, ha egy gyűjteményobjektum megelőzi, követi vagy ugyanabban a sorrendben fordul elő, mint egy második gyűjteményobjektum. Ezután megadhatja, hogy ez a definíció olyan gyűjteménytípussal legyen használva, amely elfogadja a IStructuralComparable felületet.

Az illesztő egyetlen tagból áll, amely meghatározza, CompareTohogy az aktuális gyűjteményobjektum kisebb,egyenlő vagy nagyobb-e, mint egy második objektum a rendezési sorrendben. Az aktuális példány tagjainak vagy elemeinek a második objektumban lévőkkel való tényleges összehasonlítását egy IComparer felületi implementáció végzi, amely tartalmazza az egyéni összehasonlítás definícióját.

Note

Az IStructuralComparable interfész csak a rendezéshez vagy rendezéshez használható szerkezeti összehasonlításokat támogatja. A IStructuralEquatable felület támogatja az egyéni összehasonlításokat a strukturális egyenlőség érdekében.

A .NET-keretrendszer két alapértelmezett összehasonlítót biztosít. Az egyiket a StructuralComparisons.StructuralComparer tulajdonság adja vissza, a másikat a Comparer<T>.Default tulajdonság adja vissza.

Az általános rekordosztályok (Tuple<T1>, Tuple<T1,T2>, , Tuple<T1,T2,T3>stb.) és az Array osztály explicit implementációkat biztosítanak a IStructuralComparable felülethez. Ha egy tömb vagy rekord aktuális példányát (C#-ban) vagy átalakítja (Visual Basic) egy IStructuralComparable felületi értékre, és a IComparer implementációt a CompareTo metódus argumentumaként adja meg, egyéni rendezési sorrendet határozhat meg a tömbhöz vagy gyűjteményhez. A metódust azonban a legtöbb esetben nem hívja CompareTo meg közvetlenül. Ehelyett a CompareTo metódust olyan rendezési módszerekkel hívjuk meg, mint a Sort(Array, IComparer). Ebben az esetben definiálja a megvalósítást IComparer , és argumentumként továbbítja azt egy rendezési módszernek vagy gyűjteményobjektum osztálykonstruktorának. Ezután CompareTo a rendszer automatikusan meghívja az egyéni összehasonlító metódust a gyűjtemény rendezésekor.

Metódusok

Name	Description
CompareTo(Object, IComparer)	Meghatározza, hogy az aktuális gyűjteményobjektum megelőzi-e, ugyanabban a pozícióban fordul-e elő, mint egy másik objektum, vagy egy másik objektumot követ a rendezési sorrendben.

Lásd még

• IComparable
• IStructuralEquatable
• StructuralComparer