Queryable.Average Method

Definition

Computes the average of a sequence of numeric values.

Overloads

Average(IQueryable<Nullable<Single>>)

Computes the average of a sequence of nullable Single values.

Average(IQueryable<Nullable<Int64>>)

Computes the average of a sequence of nullable Int64 values.

Average(IQueryable<Nullable<Int32>>)

Computes the average of a sequence of nullable Int32 values.

Average(IQueryable<Nullable<Double>>)

Computes the average of a sequence of nullable Double values.

Average(IQueryable<Single>)

Computes the average of a sequence of Single values.

Average(IQueryable<Int64>)

Computes the average of a sequence of Int64 values.

Average(IQueryable<Int32>)

Computes the average of a sequence of Int32 values.

Average(IQueryable<Double>)

Computes the average of a sequence of Double values.

Average(IQueryable<Decimal>)

Computes the average of a sequence of Decimal values.

Average(IQueryable<Nullable<Decimal>>)

Computes the average of a sequence of nullable Decimal values.

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>)

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

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>)

Computes the average of a sequence of nullable Single values that is obtained by invoking a projection function on each element of the input sequence.

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>)

Computes the average of a sequence of nullable Int32 values that is obtained by invoking a projection function on each element of the input sequence.

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>)

Computes the average of a sequence of nullable Double values that is obtained by invoking a projection function on each element of the input sequence.

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>)

Computes the average of a sequence of nullable Int64 values that is obtained by invoking a projection function on each element of the input sequence.

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>)

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

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>)

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

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>)

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

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>)

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

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>)

Computes the average of a sequence of nullable Decimal values that is obtained by invoking a projection function on each element of the input sequence.

Average(IQueryable<Nullable<Single>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Single values.

C#
public static float? Average(this System.Linq.IQueryable<float?> source);

Parameters

source
IQueryable<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 null values.

Exceptions

source is null.

Examples

The following code example demonstrates how to use Average(IQueryable<Nullable<Int64>>) to calculate the average of a sequence of values.

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, substitute the elements of the source sequence with elements of the appropriate numerical type.

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

double? average = longs.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Nullable<Single>>) method generates a MethodCallExpression that represents calling Average(IQueryable<Nullable<Single>>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Nullable<Single>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Nullable<Int64>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Int64 values.

C#
public static double? Average(this System.Linq.IQueryable<long?> source);

Parameters

source
IQueryable<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 null values.

Exceptions

source is null.

Examples

The following code example demonstrates how to use Average(IQueryable<Nullable<Int64>>) to calculate the average of a sequence of values.

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

double? average = longs.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Nullable<Int64>>) method generates a MethodCallExpression that represents calling Average(IQueryable<Nullable<Int64>>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Nullable<Int64>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Nullable<Int32>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Int32 values.

C#
public static double? Average(this System.Linq.IQueryable<int?> source);

Parameters

source
IQueryable<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 null values.

Exceptions

source is null.

Examples

The following code example demonstrates how to use Average(IQueryable<Nullable<Int64>>) to calculate the average of a sequence of values.

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, substitute the elements of the source sequence with elements of the appropriate numerical type.

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

double? average = longs.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Nullable<Int32>>) method generates a MethodCallExpression that represents calling Average(IQueryable<Nullable<Int32>>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Nullable<Int32>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Nullable<Double>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Double values.

C#
public static double? Average(this System.Linq.IQueryable<double?> source);

Parameters

source
IQueryable<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 null values.

Exceptions

source is null.

Examples

The following code example demonstrates how to use Average(IQueryable<Nullable<Int64>>) to calculate the average of a sequence of values.

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, substitute the elements of the source sequence with elements of the appropriate numerical type.

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

double? average = longs.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Nullable<Double>>) method generates a MethodCallExpression that represents calling Average(IQueryable<Nullable<Double>>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Nullable<Double>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Single>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of Single values.

C#
public static float Average(this System.Linq.IQueryable<float> source);

Parameters

source
IQueryable<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.

Examples

The following code example demonstrates how to use Average(IQueryable<Int32>) to calculate the average of a sequence of values.

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, substitute the elements of the source sequence with elements of the appropriate numerical type.

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

double average = grades.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Single>) method generates a MethodCallExpression that represents calling Average(IQueryable<Single>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Single>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Int64>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of Int64 values.

C#
public static double Average(this System.Linq.IQueryable<long> source);

Parameters

source
IQueryable<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.

Examples

The following code example demonstrates how to use Average(IQueryable<Int32>) to calculate the average of a sequence of values.

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, substitute the elements of the source sequence with elements of the appropriate numerical type.

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

double average = grades.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Int64>) method generates a MethodCallExpression that represents calling Average(IQueryable<Int64>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Int64>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Int32>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of Int32 values.

C#
public static double Average(this System.Linq.IQueryable<int> source);

Parameters

source
IQueryable<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(IQueryable<Int32>) to calculate the average of a sequence of values.

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

double average = grades.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Int32>) method generates a MethodCallExpression that represents calling Average(IQueryable<Int32>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Int32>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Double>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of Double values.

C#
public static double Average(this System.Linq.IQueryable<double> source);

Parameters

source
IQueryable<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.

Examples

The following code example demonstrates how to use Average(IQueryable<Int32>) to calculate the average of a sequence of values.

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, substitute the elements of the source sequence with elements of the appropriate numerical type.

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

double average = grades.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Double>) method generates a MethodCallExpression that represents calling Average(IQueryable<Double>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Double>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Decimal>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of Decimal values.

C#
public static decimal Average(this System.Linq.IQueryable<decimal> source);

Parameters

source
IQueryable<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.

Examples

The following code example demonstrates how to use Average(IQueryable<Int32>) to calculate the average of a sequence of values.

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, substitute the elements of the source sequence with elements of the appropriate numerical type.

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

double average = grades.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Decimal>) method generates a MethodCallExpression that represents calling Average(IQueryable<Decimal>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Decimal>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average(IQueryable<Nullable<Decimal>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Decimal values.

C#
public static decimal? Average(this System.Linq.IQueryable<decimal?> source);

Parameters

source
IQueryable<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 null values.

Exceptions

source is null.

Examples

The following code example demonstrates how to use Average(IQueryable<Nullable<Int64>>) to calculate the average of a sequence of values.

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, substitute the elements of the source sequence with elements of the appropriate numerical type.

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

double? average = longs.AsQueryable().Average();

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

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

Remarks

The Average(IQueryable<Nullable<Decimal>>) method generates a MethodCallExpression that represents calling Average(IQueryable<Nullable<Decimal>>) itself. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average(IQueryable<Nullable<Decimal>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

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

C#
public static float Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,float>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Single>>

A projection 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>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Single values that is obtained by invoking a projection function on each element of the input sequence.

C#
public static float? Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,float?>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Nullable<Single>>>

A projection 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 null values.

Exceptions

source or selector is null.

Examples

The following code example demonstrates how to use Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Int32 values that is obtained by invoking a projection function on each element of the input sequence.

C#
public static double? Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,int?>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Nullable<Int32>>>

A projection 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 null values.

Exceptions

source or selector is null.

Examples

The following code example demonstrates how to use Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Double values that is obtained by invoking a projection function on each element of the input sequence.

C#
public static double? Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,double?>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Nullable<Double>>>

A projection 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 null values.

Exceptions

source or selector is null.

Examples

The following code example demonstrates how to use Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Int64 values that is obtained by invoking a projection function on each element of the input sequence.

C#
public static double? Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,long?>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Nullable<Int64>>>

A projection 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 null values.

Exceptions

source or selector is null.

Examples

The following code example demonstrates how to use Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

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

C#
public static double Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,long>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Int64>>

A projection 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>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

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

C#
public static double Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,int>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Int32>>

A projection 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>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

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

C#
public static double Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,double>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Double>>

A projection 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>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

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

C#
public static decimal Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,decimal>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

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

selector
Expression<Func<TSource,Decimal>>

A projection 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>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0

Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>)

Source:
Queryable.cs
Source:
Queryable.cs
Source:
Queryable.cs

Computes the average of a sequence of nullable Decimal values that is obtained by invoking a projection function on each element of the input sequence.

C#
public static decimal? Average<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,decimal?>> selector);

Type Parameters

TSource

The type of the elements of source.

Parameters

source
IQueryable<TSource>

A sequence of values to calculate the average of.

selector
Expression<Func<TSource,Nullable<Decimal>>>

A projection 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 null values.

Exceptions

source or selector is null.

Examples

The following code example demonstrates how to use Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>) to calculate the average String length in a sequence of values of type String.

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" };

// Determine the average string length in the array.
double average = fruits.AsQueryable().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

This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

The Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>) method generates a MethodCallExpression that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>) itself as a constructed generic method. It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

The query behavior that occurs as a result of executing an expression tree that represents calling Average<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>) depends on the implementation of the type of the source parameter. The expected behavior is that it calculates the average of the values in source after invoking selector on each value.

Applies to

.NET 10 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, 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 2.0, 2.1
UWP 10.0