Enumerable.Average Método

Referência

Definição

Namespace:: System.Linq

Assembly:: System.Linq.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

public:
[System::Runtime::CompilerServices::Extension]
 static float Average(System::Collections::Generic::IEnumerable<float> ^ source);

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

static member Average : seq<single> -> single

<Extension()>
Public Function Average (source As IEnumerable(Of Single)) As Single

Parâmetros

source: IEnumerable<Single>

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

Retornos

Single

A média da sequência de valores.

Exceções

ArgumentNullException

source é null.

InvalidOperationException

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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<float> Average(System::Collections::Generic::IEnumerable<Nullable<float>> ^ source);

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

static member Average : seq<Nullable<single>> -> Nullable<single>

<Extension()>
Public Function Average (source As IEnumerable(Of Nullable(Of Single))) As Nullable(Of Single)

Parâmetros

source: IEnumerable<Nullable<Single>>

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

Retornos

Nullable<Single>

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

ArgumentNullException

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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<double> Average(System::Collections::Generic::IEnumerable<Nullable<long>> ^ source);

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

static member Average : seq<Nullable<int64>> -> Nullable<double>

<Extension()>
Public Function Average (source As IEnumerable(Of Nullable(Of Long))) As Nullable(Of Double)

Parâmetros

source: IEnumerable<Nullable<Int64>>

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

Retornos

Nullable<Double>

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

ArgumentNullException

source é null.

OverflowException

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.

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.

' Create an array of nullable long values.
Dim longs() As Nullable(Of Long) = {Nothing, 10007L, 37L, 399846234235L}

' Determine the average value in the array.
Dim avg As Nullable(Of Double) = longs.Average()

' Display the output.
Console.WriteLine($"The average is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<double> Average(System::Collections::Generic::IEnumerable<Nullable<int>> ^ source);

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

static member Average : seq<Nullable<int>> -> Nullable<double>

<Extension()>
Public Function Average (source As IEnumerable(Of Nullable(Of Integer))) As Nullable(Of Double)

Parâmetros

source: IEnumerable<Nullable<Int32>>

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

Retornos

Nullable<Double>

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

ArgumentNullException

source é null.

OverflowException

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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<double> Average(System::Collections::Generic::IEnumerable<Nullable<double>> ^ source);

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

static member Average : seq<Nullable<double>> -> Nullable<double>

<Extension()>
Public Function Average (source As IEnumerable(Of Nullable(Of Double))) As Nullable(Of Double)

Parâmetros

source: IEnumerable<Nullable<Double>>

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

Retornos

Nullable<Double>

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

ArgumentNullException

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

Cláusula Aggregate (Visual Basic)

Aplica-se a

Average(IEnumerable<Double>)

Origem:: Average.cs

Origem:: Average.cs

Origem:: Average.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static double Average(System::Collections::Generic::IEnumerable<double> ^ source);

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

static member Average : seq<double> -> double

<Extension()>
Public Function Average (source As IEnumerable(Of Double)) As Double

Parâmetros

source: IEnumerable<Double>

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

Retornos

Double

A média da sequência de valores.

Exceções

ArgumentNullException

source é null.

InvalidOperationException

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

Cláusula Aggregate (Visual Basic)

Aplica-se a

Average(IEnumerable<Int64>)

Origem:: Average.cs

Origem:: Average.cs

Origem:: Average.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static double Average(System::Collections::Generic::IEnumerable<long> ^ source);

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

static member Average : seq<int64> -> double

<Extension()>
Public Function Average (source As IEnumerable(Of Long)) As Double

Parâmetros

source: IEnumerable<Int64>

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

Retornos

Double

A média da sequência de valores.

Exceções

ArgumentNullException

source é null.

InvalidOperationException

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

Cláusula Aggregate (Visual Basic)

Aplica-se a

Average(IEnumerable<Int32>)

Origem:: Average.cs

Origem:: Average.cs

Origem:: Average.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static double Average(System::Collections::Generic::IEnumerable<int> ^ source);

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

static member Average : seq<int> -> double

<Extension()>
Public Function Average (source As IEnumerable(Of Integer)) As Double

Parâmetros

source: IEnumerable<Int32>

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

Retornos

Double

A média da sequência de valores.

Exceções

ArgumentNullException

source é null.

InvalidOperationException

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.

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.

' Create a list of integers.
Dim grades As New List(Of Integer)(New Integer() {78, 92, 100, 37, 81})

' Determine the average value in the list.
Dim avg As Double = grades.Average()

' Display the output.
Console.WriteLine($"The average grade is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

Average(IEnumerable<Decimal>)

Origem:: Average.cs

Origem:: Average.cs

Origem:: Average.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Decimal Average(System::Collections::Generic::IEnumerable<System::Decimal> ^ source);

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

static member Average : seq<decimal> -> decimal

<Extension()>
Public Function Average (source As IEnumerable(Of Decimal)) As Decimal

Parâmetros

source: IEnumerable<Decimal>

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

Retornos

Decimal

A média da sequência de valores.

Exceções

ArgumentNullException

source é null.

InvalidOperationException

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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<System::Decimal> Average(System::Collections::Generic::IEnumerable<Nullable<System::Decimal>> ^ source);

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

static member Average : seq<Nullable<decimal>> -> Nullable<decimal>

<Extension()>
Public Function Average (source As IEnumerable(Of Nullable(Of Decimal))) As Nullable(Of Decimal)

Parâmetros

source: IEnumerable<Nullable<Decimal>>

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

Retornos

Nullable<Decimal>

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

ArgumentNullException

source é null.

OverflowException

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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<double> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<int>> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, Nullable<int>> -> Nullable<double>

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Integer))) As Nullable(Of Double)

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

Nullable<Double>

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

ArgumentNullException

source ou selector é null.

OverflowException

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.

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.

' Create an array of strings.
Dim fruits() As String =
{"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' Determine the average length of the strings in the array.
Dim avg As Double = fruits.Average(Function(s) s.Length)

' Display the output.
Console.WriteLine($"The average string length is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static float Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, float> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, single> -> single

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Single)) As Single

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

Single

A média da sequência de valores.

Exceções

ArgumentNullException

source ou selector é null.

InvalidOperationException

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

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.

' Create an array of strings.
Dim fruits() As String =
{"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' Determine the average length of the strings in the array.
Dim avg As Double = fruits.Average(Function(s) s.Length)

' Display the output.
Console.WriteLine($"The average string length is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<double> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<long>> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, Nullable<int64>> -> Nullable<double>

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Long))) As Nullable(Of Double)

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

Nullable<Double>

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

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.

' Create an array of strings.
Dim numbers() As String = {"10007", "37", "299846234235"}

' Determine the average number after converting each
' string to an Int64 value.
Dim avg As Double =
numbers.Average(Function(number) Convert.ToInt64(number))

' Display the output.
Console.WriteLine($"The average is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<double> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<double>> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, Nullable<double>> -> Nullable<double>

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Double))) As Nullable(Of Double)

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

Nullable<Double>

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

ArgumentNullException

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

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.

' Create an array of strings.
Dim numbers() As String = {"10007", "37", "299846234235"}

' Determine the average number after converting each
' string to an Int64 value.
Dim avg As Double =
numbers.Average(Function(number) Convert.ToInt64(number))

' Display the output.
Console.WriteLine($"The average is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<float> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<float>> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, Nullable<single>> -> Nullable<single>

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Single))) As Nullable(Of Single)

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

Nullable<Single>

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

ArgumentNullException

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

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.

' Create an array of strings.
Dim fruits() As String =
{"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' Determine the average length of the strings in the array.
Dim avg As Double = fruits.Average(Function(s) s.Length)

' Display the output.
Console.WriteLine($"The average string length is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static double Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, long> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, int64> -> double

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Long)) As Double

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

Double

A média da sequência de valores.

Exceções

ArgumentNullException

source ou selector é null.

InvalidOperationException

source não contém elementos.

OverflowException

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.

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.

' Create an array of strings.
Dim numbers() As String = {"10007", "37", "299846234235"}

' Determine the average number after converting each
' string to an Int64 value.
Dim avg As Double =
numbers.Average(Function(number) Convert.ToInt64(number))

' Display the output.
Console.WriteLine($"The average is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static double Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, int> -> double

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Integer)) As Double

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

Double

A média da sequência de valores.

Exceções

ArgumentNullException

source ou selector é null.

InvalidOperationException

source não contém elementos.

OverflowException

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.

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.

' Create an array of strings.
Dim fruits() As String =
{"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' Determine the average length of the strings in the array.
Dim avg As Double = fruits.Average(Function(s) s.Length)

' Display the output.
Console.WriteLine($"The average string length is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static double Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, double> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, double> -> double

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Double)) As Double

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

Double

A média da sequência de valores.

Exceções

ArgumentNullException

source ou selector é null.

InvalidOperationException

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

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.

' Create an array of strings.
Dim numbers() As String = {"10007", "37", "299846234235"}

' Determine the average number after converting each
' string to an Int64 value.
Dim avg As Double =
numbers.Average(Function(number) Convert.ToInt64(number))

' Display the output.
Console.WriteLine($"The average is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Decimal Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, System::Decimal> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, decimal> -> decimal

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Decimal)) As Decimal

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

Decimal

A média da sequência de valores.

Exceções

ArgumentNullException

source ou selector é null.

InvalidOperationException

source não contém elementos.

OverflowException

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

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.

' Create an array of strings.
Dim numbers() As String = {"10007", "37", "299846234235"}

' Determine the average number after converting each
' string to an Int64 value.
Dim avg As Double =
numbers.Average(Function(number) Convert.ToInt64(number))

' Display the output.
Console.WriteLine($"The average is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

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.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<System::Decimal> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<System::Decimal>> ^ selector);

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

static member Average : seq<'Source> * Func<'Source, Nullable<decimal>> -> Nullable<decimal>

<Extension()>
Public Function Average(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Decimal))) As Nullable(Of Decimal)

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

Nullable<Decimal>

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

ArgumentNullException

source ou selector é null.

OverflowException

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

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.

' Create an array of strings.
Dim numbers() As String = {"10007", "37", "299846234235"}

' Determine the average number after converting each
' string to an Int64 value.
Dim avg As Double =
numbers.Average(Function(number) Convert.ToInt64(number))

' Display the output.
Console.WriteLine($"The average is {avg}")

' 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

Cláusula Aggregate (Visual Basic)

Aplica-se a

Compartilhar via

Enumerable.Average Método

Definição

Sobrecargas

Average(IEnumerable<Single>)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Nullable<Single>>)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Nullable<Int64>>)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Nullable<Int32>>)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Nullable<Double>>)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Double>)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Int64>)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Int32>)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Decimal>)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Average(IEnumerable<Nullable<Decimal>>)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

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

Parâmetros de tipo

Parâmetros

Retornos