Enumerable.Average Method

Definition

Computes the average of a sequence of numeric values.

Overloads

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<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,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<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,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.

Average(IEnumerable<Single>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Single values.

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

Parameters

source
IEnumerable<Single>

A sequence of Single values to calculate the average of.

Returns

The average of the sequence of values.

Exceptions

source is null.

source contains no elements.

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Single>>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of nullable Single values.

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

Parameters

source
IEnumerable<Nullable<Single>>

A sequence of nullable Single values to calculate the average of.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source is null.

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Int64>>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of nullable Int64 values.

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

Parameters

source
IEnumerable<Nullable<Int64>>

A sequence of nullable Int64 values to calculate the average of.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source is null.

The sum of the elements in the sequence is larger than Int64.MaxValue.

Examples

The following code example demonstrates how to use Average(IEnumerable<Nullable<Int64>>) to calculate an average.

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

double? average = longs.Average();

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Int32>>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of nullable Int32 values.

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

Parameters

source
IEnumerable<Nullable<Int32>>

A sequence of nullable Int32 values to calculate the average of.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source is null.

The sum of the elements in the sequence is larger than Int64.MaxValue.

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Double>>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of nullable Double values.

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

Parameters

source
IEnumerable<Nullable<Double>>

A sequence of nullable Double values to calculate the average of.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source is null.

Remarks

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.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Double>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Double values.

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

Parameters

source
IEnumerable<Double>

A sequence of Double values to calculate the average of.

Returns

The average of the sequence of values.

Exceptions

source is null.

source contains no elements.

Remarks

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.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Int64>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Int64 values.

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

Parameters

source
IEnumerable<Int64>

A sequence of Int64 values to calculate the average of.

Returns

The average of the sequence of values.

Exceptions

source is null.

source contains no elements.

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Int32>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Int32 values.

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

Parameters

source
IEnumerable<Int32>

A sequence of Int32 values to calculate the average of.

Returns

The average of the sequence of values.

Exceptions

source is null.

source contains no elements.

Examples

The following code example demonstrates how to use Average(IEnumerable<Int32>) to calculate an average.

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

double average = grades.Average();

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Decimal>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Decimal values.

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

Parameters

source
IEnumerable<Decimal>

A sequence of Decimal values to calculate the average of.

Returns

The average of the sequence of values.

Exceptions

source is null.

source contains no elements.

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Average(IEnumerable<Nullable<Decimal>>)

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of nullable Decimal values.

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

Parameters

source
IEnumerable<Nullable<Decimal>>

A sequence of nullable Decimal values to calculate the average of.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source is null.

The sum of the elements in the sequence is larger than Decimal.MaxValue.

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

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.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Nullable<Int32>>

A transform function to apply to each element.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source or selector is null.

The sum of the elements in the sequence is larger than Int64.MaxValue.

Examples

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.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Single values that are obtained by invoking a transform function on each element of the input sequence.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Single>

A transform function to apply to each element.

Returns

The average of the sequence of values.

Exceptions

source or selector is null.

source contains no elements.

Examples

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.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

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.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Nullable<Int64>>

A transform function to apply to each element.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Examples

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.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

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.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Nullable<Double>>

A transform function to apply to each element.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source or selector is null.

Examples

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.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

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.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Nullable<Single>>

A transform function to apply to each element.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source or selector is null.

Examples

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.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Int64 values that are obtained by invoking a transform function on each element of the input sequence.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Int64>

A transform function to apply to each element.

Returns

The average of the sequence of values.

Exceptions

source or selector is null.

source contains no elements.

The sum of the elements in the sequence is larger than Int64.MaxValue.

Examples

The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) to calculate an average.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Int32 values that are obtained by invoking a transform function on each element of the input sequence.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Int32>

A transform function to apply to each element.

Returns

The average of the sequence of values.

Exceptions

source or selector is null.

source contains no elements.

The sum of the elements in the sequence is larger than Int64.MaxValue.

Examples

The following code example demonstrates how to use Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) to calculate an average.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Double values that are obtained by invoking a transform function on each element of the input sequence.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Double>

A transform function to apply to each element.

Returns

The average of the sequence of values.

Exceptions

source or selector is null.

source contains no elements.

Examples

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.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

Computes the average of a sequence of Decimal values that are obtained by invoking a transform function on each element of the input sequence.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values that are used to calculate an average.

selector
Func<TSource,Decimal>

A transform function to apply to each element.

Returns

The average of the sequence of values.

Exceptions

source or selector is null.

source contains no elements.

The sum of the elements in the sequence is larger than Decimal.MaxValue.

Examples

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.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
Average.cs
Source:
Average.cs
Source:
Average.cs

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.

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

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IEnumerable<TSource>

A sequence of values to calculate the average of.

selector
Func<TSource,Nullable<Decimal>>

A transform function to apply to each element.

Returns

The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.

Exceptions

source or selector is null.

The sum of the elements in the sequence is larger than Decimal.MaxValue.

Examples

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.

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

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

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

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

Remarks

In Visual Basic query expression syntax, an Aggregate Into Average() clause translates to an invocation of Average.

See also

Applies to

.NET 9 and other versions
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
.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