Enumerable.Sum 方法

定義

命名空間:

System.Linq

組件:

System.Linq.dll

計算數值序列的總和。

多載

Sum(IEnumerable<Single>)	計算 Single 值序列的總和。
Sum(IEnumerable<Nullable<Int32>>)	計算可為 Null 之 Int32 值序列的總和。
Sum(IEnumerable<Nullable<Single>>)	計算可為 Null 之 Single 值序列的總和。
Sum(IEnumerable<Nullable<Int64>>)	計算可為 Null 之 Int64 值序列的總和。
Sum(IEnumerable<Nullable<Double>>)	計算可為 Null 之 Double 值序列的總和。
Sum(IEnumerable<Int32>)	計算 Int32 值序列的總和。
Sum(IEnumerable<Int64>)	計算 Int64 值序列的總和。
Sum(IEnumerable<Double>)	計算 Double 值序列的總和。
Sum(IEnumerable<Decimal>)	計算 Decimal 值序列的總和。
Sum(IEnumerable<Nullable<Decimal>>)	計算可為 Null 之 Decimal 值序列的總和。
Sum<TSource>(IEnumerable<TSource>, Func<TSource,Single>)	計算在輸入序列中各項目上叫用轉換函式後所取得之 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<Single>>)	計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Single 值的總和。
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<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)	計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Decimal 值的總和。

Sum(IEnumerable<Single>)

來源:

Sum.cs

計算 Single 值序列的總和。

C#

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

參數

source

IEnumerable<Single>

要計算總和的 Single 值序列。

傳回

Single

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

範例

下列程式代碼範例示範如何使用 Sum(IEnumerable<Single>) 來加總序列的值。

C#

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.
*/

備註

如果 source 不包含任何專案，這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Nullable<Int32>>)

來源:

Sum.cs

計算可為 Null 之 Int32 值序列的總和。

C#

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

參數

source

IEnumerable<Nullable<Int32>>

要計算總和之可為 Null 的 Int32 值序列。

傳回

Nullable<Int32>

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

OverflowException

總和大於 Int32.MaxValue。

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Nullable<Single>>)

來源:

Sum.cs

計算可為 Null 之 Single 值序列的總和。

C#

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

參數

source

IEnumerable<Nullable<Single>>

要計算總和之可為 Null 的 Single 值序列。

傳回

Nullable<Single>

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

範例

下列程式代碼範例示範如何使用 Sum(IEnumerable<Nullable<Single>>) 來加總序列的值。

C#

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
*/

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Nullable<Int64>>)

來源:

Sum.cs

計算可為 Null 之 Int64 值序列的總和。

C#

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

參數

source

IEnumerable<Nullable<Int64>>

要計算總和之可為 Null 的 Int64 值序列。

傳回

Nullable<Int64>

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

OverflowException

總和大於 Int64.MaxValue。

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Nullable<Double>>)

來源:

Sum.cs

計算可為 Null 之 Double 值序列的總和。

C#

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

參數

source

IEnumerable<Nullable<Double>>

要計算總和之可為 Null 的 Double 值序列。

傳回

Nullable<Double>

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

OverflowException

總和大於 Double.MaxValue。

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Int32>)

來源:

Sum.cs

計算 Int32 值序列的總和。

C#

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

參數

source

IEnumerable<Int32>

要計算總和的 Int32 值序列。

傳回

Int32

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

OverflowException

總和大於 Int32.MaxValue。

備註

如果 source 不包含任何專案，這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Int64>)

來源:

Sum.cs

計算 Int64 值序列的總和。

C#

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

參數

source

IEnumerable<Int64>

要計算總和的 Int64 值序列。

傳回

Int64

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

OverflowException

總和大於 Int64.MaxValue。

備註

如果 source 不包含任何專案，這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Double>)

來源:

Sum.cs

計算 Double 值序列的總和。

C#

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

參數

source

IEnumerable<Double>

要計算總和的 Double 值序列。

傳回

Double

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

OverflowException

總和大於 Double.MaxValue。

備註

如果 source 不包含任何專案，這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Decimal>)

來源:

Sum.cs

計算 Decimal 值序列的總和。

C#

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

參數

source

IEnumerable<Decimal>

要計算總和的 Decimal 值序列。

傳回

Decimal

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

OverflowException

總和大於 Decimal.MaxValue。

備註

如果 source 不包含任何專案，則Sum(IEnumerable<Decimal>)方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Nullable<Decimal>>)

來源:

Sum.cs

計算可為 Null 之 Decimal 值序列的總和。

C#

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

參數

source

IEnumerable<Nullable<Decimal>>

要計算總和之可為 Null 的 Decimal 值序列。

傳回

Nullable<Decimal>

序列中值的總合。

例外狀況

ArgumentNullException

source 為 null。

OverflowException

總和大於 Decimal.MaxValue。

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 Single 值序列的總和。

C#

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

類型參數

TSource

source 項目的類型。

參數

source

IEnumerable<TSource>

用來計算總和的值序列。

selector

Func<TSource,Single>

要套用至每個項目的轉換函式。

傳回

Single

預計值的總合。

例外狀況

ArgumentNullException

source 或 selector 為 null。

範例

下列程式代碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 來加總序列的投影值。

備註

此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。

C#

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
*/

備註

如果 source 不包含任何專案，則Sum<TSource>(IEnumerable<TSource>, Func<TSource,Single>)方法會傳回零。

如果您提供函式 ， selector將 的成員 source 投影到數值類型，特別是 Single，您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Int64 值的總和。

C#

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

類型參數

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>) 來加總序列的投影值。

備註

此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。

C#

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
*/

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

如果您提供函式 、 selector將 的成員 source 投影到數值類型，特別是 Nullable<Int64> C# 或 Nullable(Of Int64) Visual Basic 中的函式，您可以將這個方法套用至任意值的序列

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Int32 值的總和。

C#

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

類型參數

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>) 來加總序列的投影值。

備註

此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。

C#

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
*/

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

如果您提供函式 ， selector可將 的成員 source 投影成數值類型，特別是 Nullable<Int32> C# 或 Nullable(Of Int32) Visual Basic 中的函式，您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Double 值的總和。

C#

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

類型參數

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>) 來加總序列的投影值。

備註

此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。

C#

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
*/

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

如果您提供函式 ， selector可將 的成員 source 投影成數值類型，特別是 Nullable<Double> C# 或 Nullable(Of Double) Visual Basic 中的函式，您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Single 值的總和。

C#

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

類型參數

TSource

source 項目的類型。

參數

source

IEnumerable<TSource>

用來計算總和的值序列。

selector

Func<TSource,Nullable<Single>>

要套用至每個項目的轉換函式。

傳回

Nullable<Single>

預計值的總合。

例外狀況

ArgumentNullException

source 或 selector 為 null。

範例

下列程式代碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 來加總序列的投影值。

備註

此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。

C#

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
*/

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素為 null，則這個方法會傳回零。

如果您提供函式 ， selector可將 的成員 source 投影成數值類型，特別是 Nullable<Single> C# 或 Nullable(Of Single) Visual Basic 中的函式，您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 Int64 值序列的總和。

C#

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

類型參數

TSource

source 項目的類型。

參數

source

IEnumerable<TSource>

用來計算總和的值序列。

selector

Func<TSource,Int64>

要套用至每個項目的轉換函式。

傳回

Int64

預計值的總合。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

總和大於 Int64.MaxValue。

範例

下列程式代碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 來加總序列的投影值。

備註

此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。

C#

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
*/

備註

如果 source 不包含任何專案，這個方法會傳回零。

如果您提供函式 ， selector該函式會將 的成員 source 投影到數值類型，特別是 Int64，您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 Int32 值序列的總和。

C#

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

類型參數

TSource

source 項目的類型。

參數

source

IEnumerable<TSource>

用來計算總和的值序列。

selector

Func<TSource,Int32>

要套用至每個項目的轉換函式。

傳回

Int32

預計值的總合。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

總和大於 Int32.MaxValue。

範例

下列程式代碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 來加總序列的投影值。

備註

此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。

C#

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
*/

備註

如果 source 不包含任何專案，這個方法會傳回零。

如果您提供函式 ， selector該函式會將 的成員 source 投影到數值類型，特別是 Int32，您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 Double 值序列的總和。

C#

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

類型參數

TSource

source 項目的類型。

參數

source

IEnumerable<TSource>

用來計算總和的值序列。

selector

Func<TSource,Double>

要套用至每個項目的轉換函式。

傳回

Double

預計值的總合。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

總和大於 Double.MaxValue。

範例

下列程式代碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 來加總序列的投影值。

C#

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
*/

備註

如果 source 不包含任何專案，這個方法會傳回零。

如果您提供函式 ， selector該函式會將 的成員 source 投影到數值類型，特別是 Double，您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 Decimal 值序列的總和。

C#

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

類型參數

TSource

source 項目的類型。

參數

source

IEnumerable<TSource>

用來計算總和的值序列。

selector

Func<TSource,Decimal>

要套用至每個項目的轉換函式。

傳回

Decimal

預計值的總合。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

總和大於 Decimal.MaxValue。

範例

下列程式代碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 來加總序列的投影值。

備註

此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。

C#

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
*/

備註

如果 source 不包含任何專案，這個方法會傳回零。

如果您提供函式 ， selector該函式會將 的成員 source 投影到數值類型，特別是 Decimal，您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 Null 之 Decimal 值的總和。

C#

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

類型參數

TSource

source 項目的類型。

參數

source

IEnumerable<TSource>

用來計算總和的值序列。

selector

Func<TSource,Nullable<Decimal>>

要套用至每個項目的轉換函式。

傳回

Nullable<Decimal>

預計值的總合。

例外狀況

ArgumentNullException

source 或 selector 為 null。

OverflowException

總和大於 Decimal.MaxValue。

範例

下列程式代碼範例示範如何使用 Sum<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 來加總序列的投影值。

備註

此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。

C#

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
*/

備註

中的sourcenull專案會從總和的計算中排除。 如果 source 不包含任何專案或所有元素， null這個方法會傳回零。

如果您提供函selector式 ，可將 的成員source投影到 C# 或 Nullable(Of Decimal) Visual Basic 中的數值類型，Nullable<Decimal>您可以將這個方法套用至任意值的序列。

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

另請參閱

• Aggregate 子句 (Visual Basic)