Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Enumerable.OrderByDescending<TSource, TKey>(IEnumerable<TSource>, Func<TSource, TKey>)

 

Publicado: octubre de 2016

Ordena los elementos de una secuencia en orden descendente según una clave.

Espacio de nombres:   System.Linq
Ensamblado:  System.Core (en System.Core.dll)

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

Parámetros

source
Type: System.Collections.Generic.IEnumerable<TSource>

Secuencia de valores que se va a ordenar.

keySelector
Type: System.Func<TSource, TKey>

Función para extraer una clave a partir de un elemento.

Valor devuelto

Type: System.Linq.IOrderedEnumerable<TSource>

Una IOrderedEnumerable<TElement> cuyos elementos se ordenan en orden descendente según una clave.

Parámetros de tipo

TSource

Tipo de los elementos de source.

TKey

Tipo de la clave devuelta por keySelector.

Exception Condition
ArgumentNullException

El valor de source o keySelector es null.

Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que se enumera el objeto llamando a su GetEnumerator método directamente o mediante foreach en Visual C# o For Each en Visual Basic.

Para ordenar una secuencia por los valores de los propios elementos, especifique la función identity (x => x en Visual C# o Function(x) x en Visual Basic) para keySelector.

Para obtener un ejemplo de este método, consulte OrderByDescending<TSource, TKey>(IEnumerable<TSource>, Func<TSource, TKey>, IComparer<TKey>).

Se definen dos métodos para extender el tipo IOrderedEnumerable<TElement>, que es el tipo de valor devuelto de este método. Estos dos métodos, es decir, ThenBy y ThenByDescending, permiten especificar criterios de ordenación adicionales para ordenar una secuencia. ThenBy y ThenByDescending también devuelven un IOrderedEnumerable<TElement>, lo que significa que cualquier número de llamadas consecutivas para ThenBy o ThenByDescending pueden realizarse.

System_CAPS_noteNota

Porque IOrderedEnumerable<TElement> hereda de IEnumerable<T>, puede llamar a OrderBy o OrderByDescending en los resultados de una llamada a OrderBy, OrderByDescending, ThenBy o ThenByDescending. Esto presenta un nuevo orden primario que hace caso omiso del orden establecido previamente.

Este método compara claves utilizando el comparador predeterminado Default.

Este método realiza a una ordenación estable; es decir, si las claves de dos elementos son iguales, se conserva el orden de los elementos. Por el contrario, una ordenación inestable no conserva el orden de los elementos que tienen la misma clave.

En la sintaxis de expresión de consulta, una orderby descending (Visual C#) o Order By Descending (Visual Basic) cláusula se convierte en una invocación de OrderByDescending.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 3.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: