Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo Enumerable.OrderByDescending<TSource, TKey> (IEnumerable<TSource>, Func<TSource, TKey>, IComparer<TKey>)

Ordina in senso decrescente gli elementi di una sequenza utilizzando un operatore di confronto specificato.

Spazio dei nomi:  System.Linq
Assembly:  System.Core (in System.Core.dll)

public static IOrderedEnumerable<TSource> OrderByDescending<TSource, TKey>(
	this IEnumerable<TSource> source,
	Func<TSource, TKey> keySelector,
	IComparer<TKey> comparer
)

Parametri di tipo

TSource

Tipo degli elementi di source.

TKey

Tipo della chiave restituita dall'oggetto keySelector.

Parametri

source
Tipo: System.Collections.Generic.IEnumerable<TSource>
Sequenza di valori da ordinare.
keySelector
Tipo: System.Func<TSource, TKey>
Funzione per estrarre una chiave da un elemento.
comparer
Tipo: System.Collections.Generic.IComparer<TKey>
Oggetto IComparer<T> per confrontare le chiavi.

Valore restituito

Tipo: System.Linq.IOrderedEnumerable<TSource>
Oggetto IOrderedEnumerable<TElement> i cui elementi vengono ordinati in senso decrescente in base a una chiave.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IEnumerable<TSource>. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

EccezioneCondizione
ArgumentNullException

source o keySelector è null.

Questo metodo viene implementato tramite esecuzione posticipata. Il valore restituito immediato è un oggetto che contiene tutte le informazioni necessarie all'esecuzione dell'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato tramite chiamata diretta al relativo metodo GetEnumerator o utilizzando l'oggetto foreach in Visual C# oppure For Each in Visual Basic.

Per ordinare una sequenza in base ai valori degli stessi elementi, specificare la funzione di identità (x => x in Visual C# o Function(x) x in Visual Basic) per keySelector.

Vengono definiti due metodi per estendere il tipo IOrderedEnumerable<TElement>, che costituisce il tipo restituito da questo metodo. Questi due metodi, ovvero ThenBy e ThenByDescending, consentono di specificare criteri di ordinamento aggiuntivi per ordinare una sequenza. ThenBy e ThenByDescending restituiscono inoltre un oggetto IOrderedEnumerable<TElement> che indica che è possibile eseguire un qualsiasi numero di chiamate consecutive a ThenBy o ThenByDescending.

NotaNota

IOrderedEnumerable<TElement> eredita da IEnumerable<T>, pertanto è possibile chiamare OrderBy o OrderByDescending sui risultati di una chiamata a OrderBy, OrderByDescending, ThenBy o ThenByDescending. Tale operazione introduce un nuovo ordinamento primario che ignora l'ordinamento stabilito in precedenza.

Se comparer è null per il confronto delle chiavi viene utilizzato l'operatore di confronto predefinito Default.

Questo metodo esegue un ordinamento stabile: vale a dire che l'ordine degli elementi con chiavi uguali viene mantenuto. Un ordinamento instabile al contrario non mantiene l'ordine di elementi che presentano la stessa chiave.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare OrderByDescending<TSource, TKey>(IEnumerable<TSource>, Func<TSource, TKey>, IComparer<TKey>) per ordinare in senso decrescente gli elementi di una sequenza utilizzando una funzione di trasformazione e un operatore di confronto personalizzato.


            /// <summary>
            /// This IComparer class sorts by the fractional part of the decimal number.
            /// </summary>
            public class SpecialComparer : IComparer<decimal>
            {
                /// <summary>
                /// Compare two decimal numbers by their fractional parts.
                /// </summary>
                /// <param name="d1">The first decimal to compare.</param>
                /// <param name="d2">The second decimal to compare.</param>
                /// <returns>1 if the first decimal's fractional part 
                /// is greater than the second decimal's fractional part,
                /// -1 if the first decimal's fractional
                /// part is less than the second decimal's fractional part,
                /// or the result of calling Decimal.Compare()
                /// if the fractional parts are equal.</returns>
                public int Compare(decimal d1, decimal d2)
                {
                    decimal fractional1, fractional2;

                    // Get the fractional part of the first number.
                    try
                    {
                        fractional1 = decimal.Remainder(d1, decimal.Floor(d1));
                    }
                    catch (DivideByZeroException)
                    {
                        fractional1 = d1;
                    }
                    // Get the fractional part of the second number.
                    try
                    {
                        fractional2 = decimal.Remainder(d2, decimal.Floor(d2));
                    }
                    catch (DivideByZeroException)
                    {
                        fractional2 = d2;
                    }

                    if (fractional1 == fractional2)
                        return Decimal.Compare(d1, d2);
                    else if (fractional1 > fractional2)
                        return 1;
                    else
                        return -1;
                }
            }

            public static void OrderByDescendingEx1()
            {
                List<decimal> decimals =
                    new List<decimal> { 6.2m, 8.3m, 0.5m, 1.3m, 6.3m, 9.7m };

                IEnumerable<decimal> query =
                    decimals.OrderByDescending(num =>
                                                   num, new SpecialComparer());

                foreach (decimal num in query)
                {
                    Console.WriteLine(num);
                }
            }

            /*
             This code produces the following output:

             9.7
             0.5
             8.3
             6.3
             1.3
             6.2
            */



.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft