IStructuralComparable Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Obsługuje strukturalne porównanie obiektów kolekcji.
public interface class IStructuralComparablepublic interface IStructuralComparabletype IStructuralComparable = interfacePublic Interface IStructuralComparable- Pochodne
Przykłady
W poniższym przykładzie jest tworzona tablica Tuple<T1,T2,T3,T4,T5,T6> obiektów, która zawiera dane dotyczące populacji dla trzech miast w Stanach Zjednoczonych z 1960 do 2000 roku. Pierwszym składnikiem sekstuple jest nazwa miasta. Pozostałe pięć składników reprezentuje populację w dziesięcioletnich odstępach od 1960 do 2000 roku.
Klasa PopulationComparer zapewnia implementację IComparer , która umożliwia sortowanie tablicy sekstuple przez dowolny z jego składników. Dwie wartości są dostarczane do PopulationComparer klasy w jego konstruktorze: pozycja składnika, który definiuje kolejność sortowania, oraz wartość logiczną wskazującą, czy obiekty krotki powinny być sortowane w kolejności rosnącej lub malejącej.
W przykładzie zostaną wyświetlone elementy w tablicy w kolejności niesortowanej, posortowane według trzeciego składnika (populacji w 1970 r.), a następnie ich posortowania według szóstego składnika (populacja w 2000 r.) i wyświetla je. Należy pamiętać, że przykład nie wywołuje CompareTo metody bezpośrednio. Metoda jest wywoływana niejawnie przez metodę Sort(Array, IComparer) dla każdego obiektu krotki w tablicy.
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)
Uwagi
Interfejs IStructuralComparable umożliwia zaimplementowanie dostosowanych porównań dla elementów członkowskich kolekcji. Oznacza to, że można dokładnie zdefiniować, co oznacza, że jeden obiekt kolekcji ma poprzedzać, podążać za nim lub występować w tej samej kolejności sortowania co drugi obiekt kolekcji. Następnie można określić, że ta definicja ma być używana z typem kolekcji, który akceptuje IStructuralComparable interfejs.
Interfejs ma jeden element członkowski, CompareToktóry określa, czy bieżący obiekt kolekcji jest mniejszy niż, równy lub większy niż drugi obiekt w kolejności sortowania. Rzeczywiste porównanie elementów członkowskich lub elementów w bieżącym wystąpieniu z tymi w drugim obiekcie jest wykonywane przez implementację IComparer interfejsu, która zawiera definicję porównania niestandardowego.
Uwaga
Interfejs IStructuralComparable obsługuje tylko porównania strukturalne do sortowania lub porządkowania. Interfejs IStructuralEquatable obsługuje porównania niestandardowe pod kątem równości strukturalnej.
.NET Framework zawiera dwa domyślne porównania. Jedna z nich jest zwracana przez StructuralComparisons.StructuralComparer właściwość. Druga jest zwracana przez Comparer<T>.Default właściwość .
Ogólne klasy krotki (, , i tak dalej) i Array klasa zapewniają jawne implementacje interfejsuIStructuralComparable. Tuple<T1,T2,T3>Tuple<T1,T2>Tuple<T1> Rzutując (w języku C#) lub konwertując (w Visual Basic) bieżące wystąpienie tablicy lub krotki na IStructuralComparable wartość interfejsu i podając IComparer implementację jako argument CompareTo metody, można zdefiniować niestandardową kolejność sortowania dla tablicy lub kolekcji. Jednak metoda nie jest wywoływana CompareTo bezpośrednio w większości przypadków. Zamiast tego metoda jest wywoływana CompareTo przez metody sortowania, takie jak Sort(Array, IComparer). W takim przypadku należy zdefiniować IComparer implementację i przekazać ją jako argument do konstruktora klasy obiektu sortowania lub obiektu kolekcji. Metoda CompareTo z niestandardowym modułem porównawczym jest następnie wywoływana automatycznie za każdym razem, gdy kolekcja zostanie posortowana.
Metody
| CompareTo(Object, IComparer) |
Określa, czy bieżący obiekt kolekcji poprzedza, występuje w tej samej pozycji co inny obiekt w kolejności sortowania. |