Enumerable.Sum 方法

定義

命名空間:: System.Linq

組件:: System.Core.dll, System.Linq.dll

組件:: System.Core.dll

組件:: System.Linq.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

計算數值序列的總和。

多載

名稱	Description
Sum(IEnumerable<Nullable<Int32>>)	計算一串可 Int32 空值的總和。
Sum(IEnumerable<Nullable<Single>>)	計算一串可 Single 空值的總和。
Sum(IEnumerable<Single>)	計算一串 Single 數值的總和。
Sum(IEnumerable<Nullable<Int64>>)	計算一串可 Int64 空值的總和。
Sum(IEnumerable<Nullable<Double>>)	計算一串可 Double 空值的總和。
Sum(IEnumerable<Double>)	計算一串 Double 數值的總和。
Sum(IEnumerable<Int64>)	計算一串 Int64 數值的總和。
Sum(IEnumerable<Int32>)	計算一串 Int32 數值的總和。
Sum(IEnumerable<Decimal>)	計算一串 Decimal 數值的總和。
Sum(IEnumerable<Nullable<Decimal>>)	計算一串可 Decimal 空值的總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	計算 Single 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Single 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Int64 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Int32 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Double 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Decimal 值的序列總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)	計算 Int64 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)	計算 Int32 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>)	計算 Double 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)	計算 Decimal 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。

Sum(IEnumerable<Nullable<Int32>>)

計算一串可 Int32 空值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<int> Sum(System::Collections::Generic::IEnumerable<Nullable<int>> ^ source);

public static int? Sum(this System.Collections.Generic.IEnumerable<int?> source);

static member Sum : seq<Nullable<int>> -> Nullable<int>

<Extension()>
Public Function Sum (source As IEnumerable(Of Nullable(Of Integer))) As Nullable(Of Integer)

參數

source: IEnumerable<Nullable<Int32>>

一連串可 Int32 歸零的值，用來計算的總和。

傳回

Nullable<Int32>

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

OverflowException

這個總和比 Int32.MaxValue 還大。

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Nullable<Single>>)

計算一串可 Single 空值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<float> Sum(System::Collections::Generic::IEnumerable<Nullable<float>> ^ source);

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

static member Sum : seq<Nullable<single>> -> Nullable<single>

<Extension()>
Public Function Sum (source As IEnumerable(Of Nullable(Of Single))) As Nullable(Of Single)

參數

source: IEnumerable<Nullable<Single>>

一連串可 Single 歸零的值，用來計算的總和。

傳回

Nullable<Single>

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

範例

以下程式碼範例示範如何使用序列 Sum(IEnumerable<Nullable<Single>>) 的值求和。

float?[] points = { null, 0, 92.83F, null, 100.0F, 37.46F, 81.1F };

float? sum = points.Sum();

Console.WriteLine("Total points earned: {0}", sum);

/*
 This code produces the following output:

 Total points earned: 311.39
*/

' Create an array of Nullable Single values.
Dim points() As Nullable(Of Single) =
{Nothing, 0, 92.83F, Nothing, 100.0F, 37.46F, 81.1F}

' Get the sum of values in the list.
Dim sum As Nullable(Of Single) = points.Sum()

' Display the output.
Console.WriteLine($"Total points earned: {sum}")

' This code produces the following output:
'
' Total points earned: 311.39

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Single>)

計算一串 Single 數值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static float Sum(System::Collections::Generic::IEnumerable<float> ^ source);

public static float Sum(this System.Collections.Generic.IEnumerable<float> source);

static member Sum : seq<single> -> single

<Extension()>
Public Function Sum (source As IEnumerable(Of Single)) As Single

參數

source: IEnumerable<Single>

一連串 Single 數值用來計算總和。

傳回

Single

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

範例

以下程式碼範例示範如何使用序列 Sum(IEnumerable<Single>) 的值求和。

List<float> numbers = new List<float> { 43.68F, 1.25F, 583.7F, 6.5F };

float sum = numbers.Sum();

Console.WriteLine("The sum of the numbers is {0}.", sum);

/*
 This code produces the following output:

 The sum of the numbers is 635.13.
*/

' Create a list of Single values.
Dim numbers As New List(Of Single)(New Single() _
                               {43.68F, 1.25F, 583.7F, 6.5F})

' Get the sum of values in the list.
Dim sum As Single = numbers.Sum()

' Display the output.
Console.WriteLine($"The sum of the numbers is {sum}")

' This code produces the following output:
'
' The sum of the numbers is 635.13

備註

若 source 不包含元素，此方法回傳為零。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Nullable<Int64>>)

計算一串可 Int64 空值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<long> Sum(System::Collections::Generic::IEnumerable<Nullable<long>> ^ source);

public static long? Sum(this System.Collections.Generic.IEnumerable<long?> source);

static member Sum : seq<Nullable<int64>> -> Nullable<int64>

<Extension()>
Public Function Sum (source As IEnumerable(Of Nullable(Of Long))) As Nullable(Of Long)

參數

source: IEnumerable<Nullable<Int64>>

一連串可 Int64 歸零的值，用來計算的總和。

傳回

Nullable<Int64>

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

OverflowException

這個總和比 Int64.MaxValue 還大。

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Nullable<Double>>)

計算一串可 Double 空值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<double> Sum(System::Collections::Generic::IEnumerable<Nullable<double>> ^ source);

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

static member Sum : seq<Nullable<double>> -> Nullable<double>

<Extension()>
Public Function Sum (source As IEnumerable(Of Nullable(Of Double))) As Nullable(Of Double)

參數

source: IEnumerable<Nullable<Double>>

一連串可 Double 歸零的值，用來計算的總和。

傳回

Nullable<Double>

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

OverflowException

這個總和比 Double.MaxValue 還大。

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Double>)

計算一串 Double 數值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static double Sum(System::Collections::Generic::IEnumerable<double> ^ source);

public static double Sum(this System.Collections.Generic.IEnumerable<double> source);

static member Sum : seq<double> -> double

<Extension()>
Public Function Sum (source As IEnumerable(Of Double)) As Double

參數

source: IEnumerable<Double>

一連串 Double 數值用來計算總和。

傳回

Double

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

OverflowException

這個總和比 Double.MaxValue 還大。

備註

若 source 不包含元素，此方法回傳為零。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Int64>)

計算一串 Int64 數值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static long Sum(System::Collections::Generic::IEnumerable<long> ^ source);

public static long Sum(this System.Collections.Generic.IEnumerable<long> source);

static member Sum : seq<int64> -> int64

<Extension()>
Public Function Sum (source As IEnumerable(Of Long)) As Long

參數

source: IEnumerable<Int64>

一連串 Int64 數值用來計算總和。

傳回

Int64

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

OverflowException

這個總和比 Int64.MaxValue 還大。

備註

若 source 不包含元素，此方法回傳為零。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Int32>)

計算一串 Int32 數值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static int Sum(System::Collections::Generic::IEnumerable<int> ^ source);

public static int Sum(this System.Collections.Generic.IEnumerable<int> source);

static member Sum : seq<int> -> int

<Extension()>
Public Function Sum (source As IEnumerable(Of Integer)) As Integer

參數

source: IEnumerable<Int32>

一連串 Int32 數值用來計算總和。

傳回

Int32

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

OverflowException

這個總和比 Int32.MaxValue 還大。

備註

若 source 不包含元素，此方法回傳為零。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Decimal>)

計算一串 Decimal 數值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static System::Decimal Sum(System::Collections::Generic::IEnumerable<System::Decimal> ^ source);

public static decimal Sum(this System.Collections.Generic.IEnumerable<decimal> source);

static member Sum : seq<decimal> -> decimal

<Extension()>
Public Function Sum (source As IEnumerable(Of Decimal)) As Decimal

參數

source: IEnumerable<Decimal>

一連串 Decimal 數值用來計算總和。

傳回

Decimal

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

OverflowException

這個總和大於 Denimal.MaxValue。

備註

若source不包含任何元素，該Sum(IEnumerable<Decimal>)方法回傳為零。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

Sum(IEnumerable<Nullable<Decimal>>)

計算一串可 Decimal 空值的總和。

public:
[System::Runtime::CompilerServices::Extension]
 static Nullable<System::Decimal> Sum(System::Collections::Generic::IEnumerable<Nullable<System::Decimal>> ^ source);

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

static member Sum : seq<Nullable<decimal>> -> Nullable<decimal>

<Extension()>
Public Function Sum (source As IEnumerable(Of Nullable(Of Decimal))) As Nullable(Of Decimal)

參數

source: IEnumerable<Nullable<Decimal>>

一連串可 Decimal 歸零的值，用來計算的總和。

傳回

Nullable<Decimal>

序列中各值的總和。

例外狀況

ArgumentNullException

source 是 null。

OverflowException

這個總和大於 Denimal.MaxValue。

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算 Single 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static float Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, float> ^ selector);

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

static member Sum : seq<'Source> * Func<'Source, single> -> single

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Single)) As Single

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Single>

一個轉換函數，可以套用到每個元素。

傳回

Single

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

若source不包含任何元素，該Sum<TSource>(IEnumerable<TSource>, Func<TSource,Single>)方法回傳為零。

如果你提供一個函數 selector，將的 source 成員投影成一個數值型別，具體來說 Single，你可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Single 值的序列總和。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<float> Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<float>> ^ selector);

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

static member Sum : seq<'Source> * Func<'Source, Nullable<single>> -> Nullable<single>

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Single))) As Nullable(Of Single)

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Nullable<Single>>

一個轉換函數，可以套用到每個元素。

傳回

Nullable<Single>

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

如果你提供一個函數 selector，將 source 的成員投影成數值型態，例如在 C# 中的 Nullable<Single> 或在 Visual Basic 中的 Nullable(Of Single)，就可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Int64 值的序列總和。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<long> Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<long>> ^ selector);

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

static member Sum : seq<'Source> * Func<'Source, Nullable<int64>> -> Nullable<int64>

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Long))) As Nullable(Of Long)

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Nullable<Int64>>

一個轉換函數，可以套用到每個元素。

傳回

Nullable<Int64>

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

這個總和比 Int64.MaxValue 還大。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

如果你提供一個函數 selector，將 source 的成員投影成數值型別，例如在 C# 中的 Nullable<Int64> 或 Visual Basic 中的 Nullable(Of Int64)，就可以將此方法應用於任意數值序列

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Int32 值的序列總和。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<int> Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<int>> ^ selector);

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

static member Sum : seq<'Source> * Func<'Source, Nullable<int>> -> Nullable<int>

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Integer))) As Nullable(Of Integer)

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Nullable<Int32>>

一個轉換函數，可以套用到每個元素。

傳回

Nullable<Int32>

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

這個總和比 Int32.MaxValue 還大。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

如果你提供一個函數 selector，將 source 的成員投影成數值型態，例如在 C# 中的 Nullable<Int32> 或在 Visual Basic 中的 Nullable(Of Int32)，就可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Double 值的序列總和。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<double> Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<double>> ^ selector);

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

static member Sum : seq<'Source> * Func<'Source, Nullable<double>> -> Nullable<double>

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Double))) As Nullable(Of Double)

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Nullable<Double>>

一個轉換函數，可以套用到每個元素。

傳回

Nullable<Double>

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

這個總和比 Double.MaxValue 還大。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

如果你提供一個函數 selector，將 source 的成員投影成數值型態，例如在 C# 中的 Nullable<Double> 或在 Visual Basic 中的 Nullable(Of Double)，就可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算在輸入序列的每個元素上叫用轉換函式所取得之可為 Null Decimal 值的序列總和。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static Nullable<System::Decimal> Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<System::Decimal>> ^ selector);

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

static member Sum : seq<'Source> * Func<'Source, Nullable<decimal>> -> Nullable<decimal>

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Decimal))) As Nullable(Of Decimal)

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Nullable<Decimal>>

一個轉換函數，可以套用到每個元素。

傳回

Nullable<Decimal>

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

這個總和大於 Denimal.MaxValue。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

其中null的項目source不在計算總和之外。若 source 包含任何元素或所有元素皆為， null則此方法回傳 0。

如果你提供一個函數 selector，將 source 的成員投影成數值型態，例如在 C# 中的 Nullable<Decimal> 或在 Visual Basic 中的 Nullable(Of Decimal)，就可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算 Int64 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static long Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, long> ^ selector);

public static long Sum<TSource>(this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,long> selector);

static member Sum : seq<'Source> * Func<'Source, int64> -> int64

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Long)) As Long

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Int64>

一個轉換函數，可以套用到每個元素。

傳回

Int64

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

這個總和比 Int64.MaxValue 還大。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

若 source 不包含元素，此方法回傳為零。

如果你提供一個函數 selector，將的 source 成員投影成一個數值型別，具體來說 Int64，你可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算 Int32 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static int Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int> ^ selector);

public static int Sum<TSource>(this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int> selector);

static member Sum : seq<'Source> * Func<'Source, int> -> int

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Integer)) As Integer

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Int32>

一個轉換函數，可以套用到每個元素。

傳回

Int32

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

這個總和比 Int32.MaxValue 還大。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

若 source 不包含元素，此方法回傳為零。

如果你提供一個函數 selector，將的 source 成員投影成一個數值型別，具體來說 Int32，你可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算 Double 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static double Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, double> ^ selector);

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

static member Sum : seq<'Source> * Func<'Source, double> -> double

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Double)) As Double

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Double>

一個轉換函數，可以套用到每個元素。

傳回

Double

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

這個總和比 Double.MaxValue 還大。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

若 source 不包含元素，此方法回傳為零。

如果你提供一個函數 selector，將的 source 成員投影成一個數值型別，具體來說 Double，你可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

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

計算 Decimal 值序列的總和，這些值是在輸入序列的每個元素上叫用轉換函式所取得。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Decimal Sum(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, System::Decimal> ^ selector);

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

static member Sum : seq<'Source> * Func<'Source, decimal> -> decimal

<Extension()>
Public Function Sum(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Decimal)) As Decimal

類型參數

TSource

元素 source的類型。

參數

source: IEnumerable<TSource>

一連串用來計算總和的數值。

selector: Func<TSource,Decimal>

一個轉換函數，可以套用到每個元素。

傳回

Decimal

投影值的總和。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

這個總和大於 Denimal.MaxValue。

範例

以下程式碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 將序列的投影值求和。

Note

這個程式碼範例使用的方法的超載，與本文描述的具體超載不同。若要將範例延伸到本文描述的過載，請改變函數的主體 selector 。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void SumEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    double totalWeight = packages.Sum(pkg => pkg.Weight);

    Console.WriteLine("The total weight of the packages is: {0}", totalWeight);
}

/*
 This code produces the following output:

 The total weight of the packages is: 83.7
*/

Structure Package
    Public Company As String
    Public Weight As Double
End Structure

Sub SumEx1()
    ' Create a list of Package values.
    Dim packages As New List(Of Package)(New Package() _
     {New Package With {.Company = "Coho Vineyard", .Weight = 25.2},
      New Package With {.Company = "Lucerne Publishing", .Weight = 18.7},
      New Package With {.Company = "Wingtip Toys", .Weight = 6.0},
      New Package With {.Company = "Adventure Works", .Weight = 33.8}})

    ' Sum the values from each item's Weight property.
    Dim totalWeight As Double = packages.Sum(Function(pkg) _
                                             pkg.Weight)

    ' Display the result.
    Console.WriteLine($"The total weight of the packages is: {totalWeight}")
End Sub

' This code produces the following output:
'
' The total weight of the packages is: 83.7

備註

若 source 不包含元素，此方法回傳為零。

如果你提供一個函數 selector，將的 source 成員投影成一個數值型別，具體來說 Decimal，你可以將此方法應用於任意值序列。

在Visual Basic查詢表達式語法中，Aggregate Into Sum()子句可轉譯為Sum的呼叫。

另請參閱

彙總子句（Visual Basic）

適用於

意見反應

此頁面對您有幫助嗎？