Enumerable.Average Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Assembly:

System.Core.dll

Assembly:

netstandard.dll

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<Int32>)	Computa a média de uma sequência de valores Int32.
Average(IEnumerable<Int64>)	Computa a média de uma sequência de valores Int64.
Average(IEnumerable<Double>)	Computa a média de uma sequência de valores Double.
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<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,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<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,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<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,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,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<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(IEnumerable<Single>)

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

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Nullable<Single>>)

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

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Nullable<Int64>>)

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

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Nullable<Int32>>)

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

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Nullable<Double>>)

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á o infinito positivo ou negativo.

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Int32>)

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

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Int64>)

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

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Double>)

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á o infinito positivo ou negativo.

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Decimal>)

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

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

Confira também

• Cláusula Aggregate (Visual Basic)

Average(IEnumerable<Nullable<Decimal>>)

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

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

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica descrita neste artigo. Para estender o exemplo para a sobrecarga descrita neste artigo, altere o corpo da selector funçã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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica descrita neste artigo. Para estender o exemplo para a sobrecarga descrita neste artigo, 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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica descrita neste artigo. Para estender o exemplo para a sobrecarga descrita neste artigo, 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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica descrita neste artigo. Para estender o exemplo para a sobrecarga descrita neste artigo, altere o corpo da selector funçã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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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 descrita neste artigo. Para estender o exemplo para a sobrecarga descrita neste artigo, 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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica descrita neste artigo. Para estender o exemplo para a sobrecarga descrita neste artigo, altere o corpo da selector funçã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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica descrita neste artigo. Para estender o exemplo para a sobrecarga descrita neste artigo, altere o corpo da selector funçã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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)

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.

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

Este exemplo de código usa uma sobrecarga do método que é diferente da sobrecarga específica descrita neste artigo. Para estender o exemplo para a sobrecarga descrita neste artigo, altere o corpo da selector funçã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

Em Visual Basic sintaxe de expressão de consulta, uma Aggregate Into Average() cláusula se traduz em uma invocação de Average.

Confira também

• Cláusula Aggregate (Visual Basic)