Ler em inglês

Compartilhar via


Enumerable.Average Método

Definição

Computa a média de uma sequência de valores numéricos.

Sobrecargas

Average(IEnumerable<Single>)

Computa a média de uma sequência de valores Single.

Average(IEnumerable<Nullable<Single>>)

Computa a média de uma sequência de valores Single que permitem valores nulos.

Average(IEnumerable<Nullable<Int64>>)

Computa a média de uma sequência de valores Int64 que permitem valores nulos.

Average(IEnumerable<Nullable<Int32>>)

Computa a média de uma sequência de valores Int32 que permitem valores nulos.

Average(IEnumerable<Nullable<Double>>)

Computa a média de uma sequência de valores Double que permitem valores nulos.

Average(IEnumerable<Double>)

Computa a média de uma sequência de valores Double.

Average(IEnumerable<Int64>)

Computa a média de uma sequência de valores Int64.

Average(IEnumerable<Int32>)

Computa a média de uma sequência de valores Int32.

Average(IEnumerable<Decimal>)

Computa a média de uma sequência de valores Decimal.

Average(IEnumerable<Nullable<Decimal>>)

Computa a média de uma sequência de valores Decimal que permitem valores nulos.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)

Calcula a média de uma sequência de valores Int32 que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Single>)

Calcula a média de uma sequência de valores Single obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)

Calcula a média de uma sequência de valores Int64 que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)

Calcula a média de uma sequência de valores Double que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)

Calcula a média de uma sequência de valores Single que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)

Calcula a média de uma sequência de valores Int64 obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)

Calcula a média de uma sequência de valores Int32 obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Double>)

Calcula a média de uma sequência de valores Double obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)

Calcula a média de uma sequência de valores Decimal obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)

Calcula a média de uma sequência de valores Decimal que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

Average(IEnumerable<Single>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Single.

C#
public static float Average (this System.Collections.Generic.IEnumerable<float> source);

Parâmetros

source
IEnumerable<Single>

Uma sequência de valores Single para realizar o cálculo da média.

Retornos

A média da sequência de valores.

Exceções

source é null.

source não contém elementos.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Single>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Single que permitem valores nulos.

C#
public static float? Average (this System.Collections.Generic.IEnumerable<float?> source);

Parâmetros

source
IEnumerable<Nullable<Single>>

Uma sequência de valores Single que permitem valores nulos para cálculo da média.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source é null.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Int64>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Int64 que permitem valores nulos.

C#
public static double? Average (this System.Collections.Generic.IEnumerable<long?> source);

Parâmetros

source
IEnumerable<Nullable<Int64>>

Uma sequência de valores Int64 que permitem valores nulos para cálculo da média.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source é null.

A soma dos elementos na sequência é maior que Int64.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Average(IEnumerable<Nullable<Int64>>) para calcular uma média.

C#
long?[] longs = { null, 10007L, 37L, 399846234235L };

double? average = longs.Average();

Console.WriteLine("The average is {0}.", average);

// This code produces the following output:
//
// The average is 133282081426.333.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Int32>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Int32 que permitem valores nulos.

C#
public static double? Average (this System.Collections.Generic.IEnumerable<int?> source);

Parâmetros

source
IEnumerable<Nullable<Int32>>

Uma sequência de valores Int32 que permitem valores nulos para cálculo da média.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source é null.

A soma dos elementos na sequência é maior que Int64.MaxValue.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Double>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Double que permitem valores nulos.

C#
public static double? Average (this System.Collections.Generic.IEnumerable<double?> source);

Parâmetros

source
IEnumerable<Nullable<Double>>

Uma sequência de valores Double que permitem valores nulos para cálculo da média.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source é null.

Comentários

Se a soma dos elementos for muito grande para representar como um Double, esse método retornará infinito positivo ou negativo.

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Double>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Double.

C#
public static double Average (this System.Collections.Generic.IEnumerable<double> source);

Parâmetros

source
IEnumerable<Double>

Uma sequência de valores Double para realizar o cálculo da média.

Retornos

A média da sequência de valores.

Exceções

source é null.

source não contém elementos.

Comentários

Se a soma dos elementos for muito grande para representar como um Double, esse método retornará infinito positivo ou negativo.

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Int64>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Int64.

C#
public static double Average (this System.Collections.Generic.IEnumerable<long> source);

Parâmetros

source
IEnumerable<Int64>

Uma sequência de valores Int64 para realizar o cálculo da média.

Retornos

A média da sequência de valores.

Exceções

source é null.

source não contém elementos.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Int32>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Int32.

C#
public static double Average (this System.Collections.Generic.IEnumerable<int> source);

Parâmetros

source
IEnumerable<Int32>

Uma sequência de valores Int32 para realizar o cálculo da média.

Retornos

A média da sequência de valores.

Exceções

source é null.

source não contém elementos.

Exemplos

O exemplo de código a seguir demonstra como usar Average(IEnumerable<Int32>) para calcular uma média.

C#
List<int> grades = new List<int> { 78, 92, 100, 37, 81 };

double average = grades.Average();

Console.WriteLine("The average grade is {0}.", average);

// This code produces the following output:
//
// The average grade is 77.6.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Decimal>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Decimal.

C#
public static decimal Average (this System.Collections.Generic.IEnumerable<decimal> source);

Parâmetros

source
IEnumerable<Decimal>

Uma sequência de valores Decimal para realizar o cálculo da média.

Retornos

A média da sequência de valores.

Exceções

source é null.

source não contém elementos.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Decimal>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Computa a média de uma sequência de valores Decimal que permitem valores nulos.

C#
public static decimal? Average (this System.Collections.Generic.IEnumerable<decimal?> source);

Parâmetros

source
IEnumerable<Nullable<Decimal>>

Uma sequência de valores Decimal que permitem valores nulos para cálculo da média.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source é null.

A soma dos elementos na sequência é maior que Decimal.MaxValue.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Int32 que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static double? Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int?> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Nullable<Int32>>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source ou selector é null.

A soma dos elementos na sequência é maior que Int64.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) para calcular uma média.

Observação

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica que este artigo descreve. Para estender o exemplo para a sobrecarga que este artigo descreve, altere o corpo da selector função.

C#
string[] fruits = { "apple", "banana", "mango", "orange", "passionfruit", "grape" };

double average = fruits.Average(s => s.Length);

Console.WriteLine("The average string length is {0}.", average);

// This code produces the following output:
//
// The average string length is 6.5.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Single>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Single obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static float Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,float> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Single>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores.

Exceções

source ou selector é null.

source não contém elementos.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) para calcular uma média.

Observação

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica que este artigo descreve. Para estender o exemplo para a sobrecarga que este artigo descreve, altere o corpo da selector função.

C#
string[] fruits = { "apple", "banana", "mango", "orange", "passionfruit", "grape" };

double average = fruits.Average(s => s.Length);

Console.WriteLine("The average string length is {0}.", average);

// This code produces the following output:
//
// The average string length is 6.5.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Int64 que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static double? Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,long?> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Nullable<Int64>>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) para calcular uma média.

Observação

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica que este artigo descreve. Para estender o exemplo para a sobrecarga que este artigo descreve, altere o corpo da selector função.

C#
string[] numbers = { "10007", "37", "299846234235" };

double average = numbers.Average(num => long.Parse(num));

Console.WriteLine("The average is {0}.", average);

// This code produces the following output:
//
// The average is 99948748093.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Double que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static double? Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,double?> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Nullable<Double>>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source ou selector é null.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) para calcular uma média.

Observação

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica que este artigo descreve. Para estender o exemplo para a sobrecarga que este artigo descreve, altere o corpo da selector função.

C#
string[] numbers = { "10007", "37", "299846234235" };

double average = numbers.Average(num => long.Parse(num));

Console.WriteLine("The average is {0}.", average);

// This code produces the following output:
//
// The average is 99948748093.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Single que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static float? Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,float?> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Nullable<Single>>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source ou selector é null.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) para calcular uma média.

Observação

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica que este artigo descreve. Para estender o exemplo para a sobrecarga que este artigo descreve, altere o corpo da selector função.

C#
string[] fruits = { "apple", "banana", "mango", "orange", "passionfruit", "grape" };

double average = fruits.Average(s => s.Length);

Console.WriteLine("The average string length is {0}.", average);

// This code produces the following output:
//
// The average string length is 6.5.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Int64 obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static double Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,long> selector);

Parâmetros de tipo

TSource

O tipo dos elementos da fonte.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Int64>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores.

Exceções

source ou selector é null.

source não contém elementos.

A soma dos elementos na sequência é maior que Int64.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) para calcular uma média.

C#
string[] numbers = { "10007", "37", "299846234235" };

double average = numbers.Average(num => long.Parse(num));

Console.WriteLine("The average is {0}.", average);

// This code produces the following output:
//
// The average is 99948748093.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Int32 obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static double Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Int32>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores.

Exceções

source ou selector é null.

source não contém elementos.

A soma dos elementos na sequência é maior que Int64.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) para calcular uma média.

C#
string[] fruits = { "apple", "banana", "mango", "orange", "passionfruit", "grape" };

double average = fruits.Average(s => s.Length);

Console.WriteLine("The average string length is {0}.", average);

// This code produces the following output:
//
// The average string length is 6.5.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Double>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Double obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static double Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,double> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Double>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores.

Exceções

source ou selector é null.

source não contém elementos.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) para calcular uma média.

Observação

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica que este artigo descreve. Para estender o exemplo para a sobrecarga que este artigo descreve, altere o corpo da selector função.

C#
string[] numbers = { "10007", "37", "299846234235" };

double average = numbers.Average(num => long.Parse(num));

Console.WriteLine("The average is {0}.", average);

// This code produces the following output:
//
// The average is 99948748093.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Decimal obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static decimal Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,decimal> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores usados para calcular uma média.

selector
Func<TSource,Decimal>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores.

Exceções

source ou selector é null.

source não contém elementos.

A soma dos elementos na sequência é maior que Decimal.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) para calcular uma média.

Observação

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica que este artigo descreve. Para estender o exemplo para a sobrecarga que este artigo descreve, altere o corpo da selector função.

C#
string[] numbers = { "10007", "37", "299846234235" };

double average = numbers.Average(num => long.Parse(num));

Console.WriteLine("The average is {0}.", average);

// This code produces the following output:
//
// The average is 99948748093.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)

Origem:
Average.cs
Origem:
Average.cs
Origem:
Average.cs

Calcula a média de uma sequência de valores Decimal que permitem valor nulo obtidos pela invocação de uma função de transformação em cada elemento da sequência de entrada.

C#
public static decimal? Average<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,decimal?> selector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência de valores para cálculo da média.

selector
Func<TSource,Nullable<Decimal>>

Uma função de transformação a ser aplicada a cada elemento.

Retornos

A média da sequência de valores ou null, se a sequência de origem estiver vazia ou contiver somente valores que são null.

Exceções

source ou selector é null.

A soma dos elementos na sequência é maior que Decimal.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) para calcular uma média.

Observação

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica que este artigo descreve. Para estender o exemplo para a sobrecarga que este artigo descreve, altere o corpo da selector função.

C#
string[] numbers = { "10007", "37", "299846234235" };

double average = numbers.Average(num => long.Parse(num));

Console.WriteLine("The average is {0}.", average);

// This code produces the following output:
//
// The average is 99948748093.

Comentários

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Average() cláusula é convertida em uma invocação de Average.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0