Tuple<T1,T2,T3>.IComparable.CompareTo(Object) Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

Tuple.cs

Porovná aktuální Tuple<T1,T2,T3> objekt se zadaným objektem a vrátí celé číslo, které označuje, zda je aktuální objekt před, po nebo ve stejné pozici jako zadaný objekt v pořadí řazení.

 virtual int System.IComparable.CompareTo(System::Object ^ obj) = IComparable::CompareTo;

int IComparable.CompareTo (object obj);

abstract member System.IComparable.CompareTo : obj -> int
override this.System.IComparable.CompareTo : obj -> int

Function CompareTo (obj As Object) As Integer Implements IComparable.CompareTo

Parametry

obj

Object

Objekt k porovnání s aktuální instancí.

Návraty

Int32

Celé číslo se znaménkem, které označuje relativní pozici této instance a obj v pořadí řazení, jak je znázorněno v následující tabulce.

Hodnota	Popis
Záporné celé číslo	Tato instance předchází obj.
Žádnou	Tato instance a obj mají stejnou pozici v pořadí řazení.
Kladné celé číslo	Tato instance následuje po obj.

Implementuje

CompareTo(Object)

Výjimky

ArgumentException

obj není Tuple<T1,T2,T3> objekt.

Příklady

Následující příklad vytvoří pole Tuple<T1,T2,T3> objektů, jejichž komponenty se skládají ze jména studenta, průměrného skóre testu a počtu testů. Zobrazí součásti každé řazené kolekce členů v poli v neseřazené pořadí, seřadí pole a potom zavolá volání ToString , aby se každá řazená kolekce členů zobrazila v seřazené pořadí. Výstup ukazuje, že pole bylo seřazeno podle první komponenty. Všimněte si, že příklad nevolá přímo metodu Tuple<T1,T2,T3>.IComparable.CompareTo . Tato metoda je volána implicitně metodou Sort(Array) pro každý prvek v poli.

using System;

public class Example
{
   public static void Main()
   {
      Tuple<string, double, int>[] scores = 
                    { Tuple.Create("Jack", 78.8, 8),
                      Tuple.Create("Abbey", 92.1, 9), 
                      Tuple.Create("Dave", 88.3, 9),
                      Tuple.Create("Sam", 91.7, 8), 
                      Tuple.Create("Ed", 71.2, 5),
                      Tuple.Create("Penelope", 82.9, 8),
                      Tuple.Create("Linda", 99.0, 9),
                      Tuple.Create("Judith", 84.3, 9) };

      Console.WriteLine("The values in unsorted order:");
      foreach (var score in scores)
         Console.WriteLine(score.ToString());

      Console.WriteLine();

      Array.Sort(scores);

      Console.WriteLine("The values in sorted order:");
      foreach (var score in scores)
         Console.WriteLine(score.ToString());
   }
}
// The example displays the following output;
//    The values in unsorted order:
//    (Jack, 78.8, 8)
//    (Abbey, 92.1, 9)
//    (Dave, 88.3, 9)
//    (Sam, 91.7, 8)
//    (Ed, 71.2, 5)
//    (Penelope, 82.9, 8)
//    (Linda, 99, 9)
//    (Judith, 84.3, 9)
//    
//    The values in sorted order:
//    (Abbey, 92.1, 9)
//    (Dave, 88.3, 9)
//    (Ed, 71.2, 5)
//    (Jack, 78.8, 8)
//    (Judith, 84.3, 9)
//    (Linda, 99, 9)
//    (Penelope, 82.9, 8)
//    (Sam, 91.7, 8)

open System

let scores = 
    [| Tuple.Create("Jack", 78.8, 8)
       Tuple.Create("Abbey", 92.1, 9)
       Tuple.Create("Dave", 88.3, 9)
       Tuple.Create("Sam", 91.7, 8)
       Tuple.Create("Ed", 71.2, 5)
       Tuple.Create("Penelope", 82.9, 8)
       Tuple.Create("Linda", 99.0, 9)
       Tuple.Create("Judith", 84.3, 9) |]
 
printfn "The values in unsorted order:"
for score in scores do
    printfn $"{score}"

printfn ""

Array.Sort scores

printfn "The values in sorted order"
for score in scores do
    printfn $"{score}"
// The example displays the following output
//    The values in unsorted order:
//    (Jack, 78.8, 8)
//    (Abbey, 92.1, 9)
//    (Dave, 88.3, 9)
//    (Sam, 91.7, 8)
//    (Ed, 71.2, 5)
//    (Penelope, 82.9, 8)
//    (Linda, 99, 9)
//    (Judith, 84.3, 9)
//    
//    The values in sorted order:
//    (Abbey, 92.1, 9)
//    (Dave, 88.3, 9)
//    (Ed, 71.2, 5)
//    (Jack, 78.8, 8)
//    (Judith, 84.3, 9)
//    (Linda, 99, 9)
//    (Penelope, 82.9, 8)
//    (Sam, 91.7, 8)

Module Example
   Public Sub Main()
      Dim scores() = 
                 { Tuple.Create("Jack", 78.8, 8),
                   Tuple.Create("Abbey", 92.1, 9), 
                   Tuple.Create("Dave", 88.3, 9),
                   Tuple.Create("Sam", 91.7, 8), 
                   Tuple.Create("Ed", 71.2, 5),
                   Tuple.Create("Penelope", 82.9, 8),
                   Tuple.Create("Linda", 99.0, 9),
                   Tuple.Create("Judith", 84.3, 9) }

      Console.WriteLine("The values in unsorted order:")
      For Each score In scores
         Console.WriteLine(score.ToString())
      Next
      Console.WriteLine()

      Array.Sort(scores)

      Console.WriteLine("The values in sorted order:")
      For Each score In scores
         Console.WriteLine(score.ToString())
      Next
   End Sub
End Module
' The example displays the following output;
'    The values in unsorted order:
'    (Jack, 78.8, 8)
'    (Abbey, 92.1, 9)
'    (Dave, 88.3, 9)
'    (Sam, 91.7, 8)
'    (Ed, 71.2, 5)
'    (Penelope, 82.9, 8)
'    (Linda, 99, 9)
'    (Judith, 84.3, 9)
'    
'    The values in sorted order:
'    (Abbey, 92.1, 9)
'    (Dave, 88.3, 9)
'    (Ed, 71.2, 5)
'    (Jack, 78.8, 8)
'    (Judith, 84.3, 9)
'    (Linda, 99, 9)
'    (Penelope, 82.9, 8)
'    (Sam, 91.7, 8)

Poznámky

Tento člen je explicitní implementace členu rozhraní. Lze jej použít pouze v případě, že Tuple<T1,T2,T3> je instance přetypovaná na IComparable rozhraní.

Tato metoda poskytuje implementaci IComparable.CompareTo pro Tuple<T1,T2,T3> třídu . I když lze metodu volat přímo, je nejčastěji volána výchozími přetíženími metod řazení kolekcí, jako Array.Sort(Array) jsou a SortedList.Add, k seřazení členů kolekce.

Upozornění

Metoda Tuple<T1,T2,T3>.IComparable.CompareTo je určena pro použití v operacích řazení. Není vhodné jej používat, pokud je primárním účelem porovnání zjištění, zda se dva objekty rovnají. Chcete-li zjistit, zda jsou dva objekty rovny, zavolejte metodu Equals .

Metoda Tuple<T1,T2,T3>.IComparable.CompareTo používá výchozí porovnávače objektů k porovnání jednotlivých komponent.

Viz také

• Equals(Object)