Enumerable.Average 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
計算數值序列的平均值。
- 來源:
- Average.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算 Single 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static float Average(System::Collections::Generic::IEnumerable<float> ^ source);C#
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參數
- source
- IEnumerable<Single>
要計算平均值的 Single 值序列。
傳回
值序列的平均。
例外狀況
source 為 null。
source 沒有包含任何項目。
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算可為 Null 之 Single 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<float> Average(System::Collections::Generic::IEnumerable<Nullable<float>> ^ source);C#
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)參數
- source
- IEnumerable<Nullable<Single>>
要計算其平均值的可為 Null 之 Single 值的序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 為 null。
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算可為 Null 之 Int64 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<double> Average(System::Collections::Generic::IEnumerable<Nullable<long>> ^ source);C#
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)參數
- source
- IEnumerable<Nullable<Int64>>
要計算其平均值的可為 Null 之 Int64 值的序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 為 null。
序列中專案的總和大於 Int64.MaxValue。
範例
下列程式代碼範例示範如何使用 Average(IEnumerable<Nullable<Int64>>) 來計算平均值。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算可為 Null 之 Int32 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<double> Average(System::Collections::Generic::IEnumerable<Nullable<int>> ^ source);C#
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)參數
- source
- IEnumerable<Nullable<Int32>>
要計算其平均值的可為 Null 之 Int32 值的序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 為 null。
序列中專案的總和大於 Int64.MaxValue。
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算可為 Null 之 Double 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<double> Average(System::Collections::Generic::IEnumerable<Nullable<double>> ^ source);C#
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)參數
- source
- IEnumerable<Nullable<Double>>
要計算其平均值的可為 Null 之 Double 值的序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 為 null。
備註
如果專案的總和太大而無法表示為 Double，這個方法會傳回正數或負無限大。
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算 Double 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static double Average(System::Collections::Generic::IEnumerable<double> ^ source);C#
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參數
- source
- IEnumerable<Double>
要計算平均值的 Double 值序列。
傳回
值序列的平均。
例外狀況
source 為 null。
source 沒有包含任何項目。
備註
如果專案的總和太大而無法表示為 Double，這個方法會傳回正數或負無限大。
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算 Int64 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static double Average(System::Collections::Generic::IEnumerable<long> ^ source);C#
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參數
- source
- IEnumerable<Int64>
要計算平均值的 Int64 值序列。
傳回
值序列的平均。
例外狀況
source 為 null。
source 沒有包含任何項目。
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算 Int32 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static double Average(System::Collections::Generic::IEnumerable<int> ^ source);C#
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參數
- source
- IEnumerable<Int32>
要計算平均值的 Int32 值序列。
傳回
值序列的平均。
例外狀況
source 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Average(IEnumerable<Int32>) 來計算平均值。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算 Decimal 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static System::Decimal Average(System::Collections::Generic::IEnumerable<System::Decimal> ^ source);C#
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參數
- source
- IEnumerable<Decimal>
要計算平均值的 Decimal 值序列。
傳回
值序列的平均。
例外狀況
source 為 null。
source 沒有包含任何項目。
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算可為 Null 之 Decimal 值序列的平均值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<System::Decimal> Average(System::Collections::Generic::IEnumerable<Nullable<System::Decimal>> ^ source);C#
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)參數
- source
- IEnumerable<Nullable<Decimal>>
要計算其平均值的可為 Null 之 Decimal 值的序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 為 null。
序列中專案的總和大於 Decimal.MaxValue。
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Int32 值的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<double> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<int>> ^ selector);C#
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)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 或 selector 為 null。
序列中專案的總和大於 Int64.MaxValue。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來計算平均值。
備註
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得之 Single 值序列的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static float Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, float> ^ selector);C#
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類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來計算平均值。
備註
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Int64 值的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<double> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<long>> ^ selector);C#
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)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) 來計算平均值。
備註
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Double 值的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<double> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<double>> ^ selector);C#
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)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 或 selector 為 null。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) 來計算平均值。
備註
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Single 值的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<float> Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<float>> ^ selector);C#
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)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 或 selector 為 null。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來計算平均值。
備註
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得之 Int64 值序列的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static double Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, long> ^ selector);C#
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類型參數
- TSource
來源之項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
序列中專案的總和大於 Int64.MaxValue。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) 來計算平均值。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得之 Int32 值序列的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static double Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int> ^ selector);C#
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類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
序列中專案的總和大於 Int64.MaxValue。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來計算平均值。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中， Aggregate Into Average() 子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得之 Double 值序列的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static double Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, double> ^ selector);C#
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類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) 來計算平均值。
備註
此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中 Aggregate Into Average() ，子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得之 Decimal 值序列的平均值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Decimal Average(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, System::Decimal> ^ selector);C#
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類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
用來計算平均值的值序列。
傳回
值序列的平均。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
序列中元素的總和大於 Decimal.MaxValue。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) 來計算平均值。
備註
此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中 Aggregate Into Average() ，子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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.cs
- 來源:
- Average.cs
- 來源:
- Average.cs
計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Decimal 值的平均值。
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);C#
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)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要計算平均值的值序列。
傳回
值序列的平均值，或者，如果來源序列是空的或只包含 null 值，則為 null。
例外狀況
source 或 selector 為 null。
序列中元素的總和大於 Decimal.MaxValue。
範例
下列程式代碼範例示範如何使用 Average<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) 來計算平均值。
備註
此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。
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.
' 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
備註
在 Visual Basic 查詢表達式語法中 Aggregate Into Average() ，子句會轉譯為的 Average調用。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .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 |
