Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

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

Classifica os elementos de uma sequência em ordem decrescente de acordo com uma chave.

Namespace:  System.Linq
Assembly:  System.Core (em System.Core.dll)

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

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo de chave retornada por keySelector.

Parâmetros

source
Tipo: System.Collections.Generic.IEnumerable<TSource>
Uma sequência de valores à ordenação.
keySelector
Tipo: System.Func<TSource, TKey>
Uma função para extrair uma chave de um elemento.

Valor de retorno

Tipo: System.Linq.IOrderedEnumerable<TSource>
IOrderedEnumerable<TElement> cujos elementos são classificados em ordem decrescente de acordo com uma chave.

Observação de uso

No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo IEnumerable<TSource>. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (Guia de Programação em C#).

ExceçãoCondição
ArgumentNullException

source ou keySelector é null.

Esse método é implementado usando a execução diferida. O valor de retorno imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando o método de GetEnumerator diretamente ou usando foreach em Visual C# ou For Each em Visual Basic.

Para ordenar uma sequência pelos valores dos elementos ela mesma, especifique a função IDENTITY (x => x em Visual C# ou em Function(x) x em Visual Basic) para keySelector.

Para obter um exemplo desse método, consulte o OrderByDescending<TSource, TKey>(IEnumerable<TSource>, Func<TSource, TKey>, IComparer<TKey>).

Dois métodos são definidos para estender o tipo IOrderedEnumerable<TElement>, que é o tipo de retorno desse método. Esses dois métodos, isto é ThenBy e ThenByDescending, permite especificar critérios de classificação adicionais para classificar uma sequência. ThenBy e ThenByDescending também retornam IOrderedEnumerable<TElement>, o que significa que qualquer número de chamadas consecutivos a ThenBy ou de ThenByDescending pode ser feito.

ObservaçãoObservação

Como IOrderedEnumerable<TElement> herda de IEnumerable<T>, você pode chamar OrderBy ou OrderByDescending nos resultados de uma chamada para OrderBy, OrderByDescending, ThenBy ou ThenByDescending. Isso apresenta um novo primário de ordenação que ignora a ordenação estabelecido anteriormente.

Esse método compara chaves usando o comparador padrão Default.

Esse método executa um tipo estável; ou seja, se as chaves de dois elementos são iguais, a ordem dos elementos é preservada. Por outro lado, um tipo instável não preserva a ordem de elementos que têm a mesma chave.

Na sintaxe da expressão de consulta, uma cláusula de orderby descending (Visual C#) ou de Order By Descending (Visual Basic) converte a uma invocação de OrderByDescending.

.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: 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 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2015 Microsoft