Ask Learn
Preview
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign inThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Computes the average of a sequence of numeric values.
Average(IEnumerable<Single>) |
Computes the average of a sequence of Single values. |
Average(IEnumerable<Nullable<Single>>) |
Computes the average of a sequence of nullable Single values. |
Average(IEnumerable<Nullable<Int64>>) |
Computes the average of a sequence of nullable Int64 values. |
Average(IEnumerable<Nullable<Int32>>) |
Computes the average of a sequence of nullable Int32 values. |
Average(IEnumerable<Nullable<Double>>) |
Computes the average of a sequence of nullable Double values. |
Average(IEnumerable<Double>) |
Computes the average of a sequence of Double values. |
Average(IEnumerable<Int64>) |
Computes the average of a sequence of Int64 values. |
Average(IEnumerable<Int32>) |
Computes the average of a sequence of Int32 values. |
Average(IEnumerable<Decimal>) |
Computes the average of a sequence of Decimal values. |
Average(IEnumerable<Nullable<Decimal>>) |
Computes the average of a sequence of nullable Decimal values. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>) |
Computes the average of a sequence of nullable Int32 values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Single>) |
Computes the average of a sequence of Single values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>) |
Computes the average of a sequence of nullable Single values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>) |
Computes the average of a sequence of nullable Double values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>) |
Computes the average of a sequence of nullable Int64 values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) |
Computes the average of a sequence of Int64 values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) |
Computes the average of a sequence of Int32 values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Double>) |
Computes the average of a sequence of Double values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>) |
Computes the average of a sequence of Decimal values that are obtained by invoking a transform function on each element of the input sequence. |
Average<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>) |
Computes the average of a sequence of nullable Decimal values that are obtained by invoking a transform function on each element of the input sequence. |
Computes the average of a sequence of Single values.
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
A sequence of Single values to calculate the average of.
The average of the sequence of values.
source
is null
.
source
contains no elements.
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Single values.
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)
A sequence of nullable Single values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
is null
.
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Int64 values.
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)
A sequence of nullable Int64 values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
is null
.
The sum of the elements in the sequence is larger than Int64.MaxValue.
The following code example demonstrates how to use Average(IEnumerable<Nullable<Int64>>) to calculate an average.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Int32 values.
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)
A sequence of nullable Int32 values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
is null
.
The sum of the elements in the sequence is larger than Int64.MaxValue.
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Double values.
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)
A sequence of nullable Double values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
is null
.
If the sum of the elements is too large to represent as a Double, this method returns positive or negative infinity.
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Double values.
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
A sequence of Double values to calculate the average of.
The average of the sequence of values.
source
is null
.
source
contains no elements.
If the sum of the elements is too large to represent as a Double, this method returns positive or negative infinity.
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Int64 values.
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
A sequence of Int64 values to calculate the average of.
The average of the sequence of values.
source
is null
.
source
contains no elements.
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Int32 values.
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
A sequence of Int32 values to calculate the average of.
The average of the sequence of values.
source
is null
.
source
contains no elements.
The following code example demonstrates how to use Average(IEnumerable<Int32>) to calculate an average.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Decimal values.
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
A sequence of Decimal values to calculate the average of.
The average of the sequence of values.
source
is null
.
source
contains no elements.
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Decimal values.
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)
A sequence of nullable Decimal values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
is null
.
The sum of the elements in the sequence is larger than Decimal.MaxValue.
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Int32 values that are obtained by invoking a transform function on each element of the input sequence.
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)
The type of the elements of source
.
A sequence of values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
or selector
is null
.
The sum of the elements in the sequence is larger than Int64.MaxValue.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) to calculate an average.
Note
This code example uses an overload of the method that's different from the specific overload that this article describes. To extend the example to the overload that this article describes, change the body of the selector
function.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Single values that are obtained by invoking a transform function on each element of the input sequence.
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
The type of the elements of source
.
A sequence of values to calculate the average of.
The average of the sequence of values.
source
or selector
is null
.
source
contains no elements.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) to calculate an average.
Note
This code example uses an overload of the method that's different from the specific overload that this article describes. To extend the example to the overload that this article describes, change the body of the selector
function.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Single values that are obtained by invoking a transform function on each element of the input sequence.
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)
The type of the elements of source
.
A sequence of values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
or selector
is null
.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) to calculate an average.
Note
This code example uses an overload of the method that's different from the specific overload that this article describes. To extend the example to the overload that this article describes, change the body of the selector
function.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Double values that are obtained by invoking a transform function on each element of the input sequence.
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)
The type of the elements of source
.
A sequence of values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
or selector
is null
.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) to calculate an average.
Note
This code example uses an overload of the method that's different from the specific overload that this article describes. To extend the example to the overload that this article describes, change the body of the selector
function.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Int64 values that are obtained by invoking a transform function on each element of the input sequence.
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)
The type of the elements of source
.
A sequence of values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) to calculate an average.
Note
This code example uses an overload of the method that's different from the specific overload that this article describes. To extend the example to the overload that this article describes, change the body of the selector
function.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Int64 values that are obtained by invoking a transform function on each element of the input sequence.
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
The type of the elements of source.
A sequence of values to calculate the average of.
The average of the sequence of values.
source
or selector
is null
.
source
contains no elements.
The sum of the elements in the sequence is larger than Int64.MaxValue.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) to calculate an average.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Int32 values that are obtained by invoking a transform function on each element of the input sequence.
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
The type of the elements of source
.
A sequence of values to calculate the average of.
The average of the sequence of values.
source
or selector
is null
.
source
contains no elements.
The sum of the elements in the sequence is larger than Int64.MaxValue.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) to calculate an average.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Double values that are obtained by invoking a transform function on each element of the input sequence.
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
The type of the elements of source
.
A sequence of values to calculate the average of.
The average of the sequence of values.
source
or selector
is null
.
source
contains no elements.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) to calculate an average.
Note
This code example uses an overload of the method that's different from the specific overload that this article describes. To extend the example to the overload that this article describes, change the body of the selector
function.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of Decimal values that are obtained by invoking a transform function on each element of the input sequence.
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
The type of the elements of source
.
A sequence of values that are used to calculate an average.
The average of the sequence of values.
source
or selector
is null
.
source
contains no elements.
The sum of the elements in the sequence is larger than Decimal.MaxValue.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) to calculate an average.
Note
This code example uses an overload of the method that's different from the specific overload that this article describes. To extend the example to the overload that this article describes, change the body of the selector
function.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
Computes the average of a sequence of nullable Decimal values that are obtained by invoking a transform function on each element of the input sequence.
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)
The type of the elements of source
.
A sequence of values to calculate the average of.
The average of the sequence of values, or null
if the source sequence is empty or contains only values that are null
.
source
or selector
is null
.
The sum of the elements in the sequence is larger than Decimal.MaxValue.
The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) to calculate an average.
Note
This code example uses an overload of the method that's different from the specific overload that this article describes. To extend the example to the overload that this article describes, change the body of the selector
function.
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
In Visual Basic query expression syntax, an Aggregate Into Average()
clause translates to an invocation of Average.
Product | Versions |
---|---|
.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, 10 |
.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 |
.NET feedback
.NET is an open source project. Select a link to provide feedback:
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign in