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 值序列的總和。

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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Nullable<Int32>>)

來源:

Sum.cs

計算可為 Null 之 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>>

要計算總和之可為 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 值序列的總和。

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

要計算總和之可為 Null 的 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

備註

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

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Nullable<Int64>>)

來源:

Sum.cs

計算可為 Null 之 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>>

要計算總和之可為 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 值序列的總和。

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

要計算總和之可為 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 值序列的總和。

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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Int64>)

來源:

Sum.cs

計算 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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Double>)

來源:

Sum.cs

計算 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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Decimal>)

來源:

Sum.cs

計算 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

總和大於 Decimal.MaxValue。

備註

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

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

另請參閱

• Aggregate 子句 (Visual Basic)

Sum(IEnumerable<Nullable<Decimal>>)

來源:

Sum.cs

計算可為 Null 之 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>>

要計算總和之可為 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 值序列的總和。

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

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 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>) 來加總序列的投影值。

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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

備註

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

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

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 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>) 來加總序列的投影值。

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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

備註

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

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

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 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>) 來加總序列的投影值。

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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

備註

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

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

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 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>) 來加總序列的投影值。

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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

備註

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

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

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

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 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>) 來加總序列的投影值。

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 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>) 來加總序列的投影值。

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得之 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

總和大於 Decimal.MaxValue。

範例

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

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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 調用。

另請參閱

• Aggregate 子句 (Visual Basic)

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

來源:

Sum.cs

計算在輸入序列中各項目上叫用轉換函式後所取得可為 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

總和大於 Decimal.MaxValue。

範例

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

注意

此程式碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 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

備註

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

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

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

另請參閱

• Aggregate 子句 (Visual Basic)