Enumerable.Max 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
傳回值序列中的最大值。
多載
Max(IEnumerable<Nullable<Int32>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回可為 Null 之 Int32 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<int> Max(System::Collections::Generic::IEnumerable<Nullable<int>> ^ source);public static int? Max (this System.Collections.Generic.IEnumerable<int?> source);static member Max : seq<Nullable<int>> -> Nullable<int><Extension()>
Public Function Max (source As IEnumerable(Of Nullable(Of Integer))) As Nullable(Of Integer)參數
- source
- IEnumerable<Nullable<Int32>>
要判斷最大值之可為 Null 的 Int32 值序列。
傳回
C# 或 Nullable(Of Int32) Visual Basic 中類型的Nullable<Int32>值，對應至序列中的最大值。
例外狀況
source 為 null。
備註
方法 Max(IEnumerable<Nullable<Int32>>) 會 Int32 使用的實作 IComparable<T> 來比較值。
如果來源序列是空的，或只包含的值 null，則此函式會傳 null回 。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Single>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回 Single 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static float Max(System::Collections::Generic::IEnumerable<float> ^ source);public static float Max (this System.Collections.Generic.IEnumerable<float> source);static member Max : seq<single> -> single<Extension()>
Public Function Max (source As IEnumerable(Of Single)) As Single參數
- source
- IEnumerable<Single>
要判斷最大值的 Single 值序列。
傳回
序列中的最大值。
例外狀況
source 為 null。
source 沒有包含任何項目。
備註
方法 Max(IEnumerable<Single>) 會 Single 使用的實作 IComparable<T> 來比較值。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Nullable<Single>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回可為 Null 之 Single 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<float> Max(System::Collections::Generic::IEnumerable<Nullable<float>> ^ source);public static float? Max (this System.Collections.Generic.IEnumerable<float?> source);static member Max : seq<Nullable<single>> -> Nullable<single><Extension()>
Public Function Max (source As IEnumerable(Of Nullable(Of Single))) As Nullable(Of Single)參數
- source
- IEnumerable<Nullable<Single>>
要判斷最大值之可為 Null 的 Single 值序列。
傳回
C# 或 Nullable(Of Single) Visual Basic 中類型的Nullable<Single>值，對應至序列中的最大值。
例外狀況
source 為 null。
備註
方法 Max(IEnumerable<Nullable<Single>>) 會 Single 使用的實作 IComparable<T> 來比較值。
如果來源序列是空的，或只包含的值 null，則此函式會傳 null回 。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Nullable<Int64>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回可為 Null 之 Int64 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<long> Max(System::Collections::Generic::IEnumerable<Nullable<long>> ^ source);public static long? Max (this System.Collections.Generic.IEnumerable<long?> source);static member Max : seq<Nullable<int64>> -> Nullable<int64><Extension()>
Public Function Max (source As IEnumerable(Of Nullable(Of Long))) As Nullable(Of Long)參數
- source
- IEnumerable<Nullable<Int64>>
要判斷最大值之可為 Null 的 Int64 值序列。
傳回
C# 或 Nullable(Of Int64) Visual Basic 中類型的Nullable<Int64>值，對應至序列中的最大值。
例外狀況
source 為 null。
備註
方法 Max(IEnumerable<Nullable<Int64>>) 會 Int64 使用的實作 IComparable<T> 來比較值。
如果來源序列是空的，或只包含的值 null，則此函式會傳 null回 。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Nullable<Double>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回可為 Null 之 Double 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<double> Max(System::Collections::Generic::IEnumerable<Nullable<double>> ^ source);public static double? Max (this System.Collections.Generic.IEnumerable<double?> source);static member Max : seq<Nullable<double>> -> Nullable<double><Extension()>
Public Function Max (source As IEnumerable(Of Nullable(Of Double))) As Nullable(Of Double)參數
- source
- IEnumerable<Nullable<Double>>
要判斷最大值之可為 Null 的 Double 值序列。
傳回
C# 或 Nullable(Of Double) Visual Basic 中類型的Nullable<Double>值，對應至序列中的最大值。
例外狀況
source 為 null。
範例
下列程式代碼範例示範如何使用 Max(IEnumerable<Nullable<Double>>) 來判斷序列中的最大值。
double?[] doubles = { null, 1.5E+104, 9E+103, -2E+103 };
double? max = doubles.Max();
Console.WriteLine("The largest number is {0}.", max);
/*
This code produces the following output:
The largest number is 1.5E+104.
*/
' Create an array of Nullable Double values.
Dim doubles() As Nullable(Of Double) =
{Nothing, 1.5E+104, 9.0E+103, -2.0E+103}
' Determine the maximum value in the array.
Dim max As Nullable(Of Double) = doubles.Max()
' Display the result.
Console.WriteLine($"The largest number is {max}")
' This code produces the following output:
'
' The largest number is 1.5E+104
備註
方法 Max(IEnumerable<Nullable<Double>>) 會 Double 使用的實作 IComparable<T> 來比較值。
如果來源序列是空的，或只包含的值 null，則此函式會傳 null回 。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Double>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回 Double 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static double Max(System::Collections::Generic::IEnumerable<double> ^ source);public static double Max (this System.Collections.Generic.IEnumerable<double> source);static member Max : seq<double> -> double<Extension()>
Public Function Max (source As IEnumerable(Of Double)) As Double參數
- source
- IEnumerable<Double>
要判斷最大值的 Double 值序列。
傳回
序列中的最大值。
例外狀況
source 為 null。
source 沒有包含任何項目。
備註
方法 Max(IEnumerable<Double>) 會 Double 使用的實作 IComparable<T> 來比較值。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Int64>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回 Int64 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static long Max(System::Collections::Generic::IEnumerable<long> ^ source);public static long Max (this System.Collections.Generic.IEnumerable<long> source);static member Max : seq<int64> -> int64<Extension()>
Public Function Max (source As IEnumerable(Of Long)) As Long參數
- source
- IEnumerable<Int64>
要判斷最大值的 Int64 值序列。
傳回
序列中的最大值。
例外狀況
source 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Max(IEnumerable<Int64>) 來判斷序列中的最大值。
List<long> longs = new List<long> { 4294967296L, 466855135L, 81125L };
long max = longs.Max();
Console.WriteLine("The largest number is {0}.", max);
/*
This code produces the following output:
The largest number is 4294967296.
*/
' Create a list of Long values.
Dim longs As New List(Of Long)(New Long() _
{4294967296L, 466855135L, 81125L})
' Get the maximum value in the list.
Dim max As Long = longs.Max()
' Display the result.
Console.WriteLine($"The largest number is {max}")
' This code produces the following output:
'
' The largest number is 4294967296
備註
方法Max(IEnumerable<Int64>)會使用的 IComparable<T> 實作Int64來比較值。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Int32>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回 Int32 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static int Max(System::Collections::Generic::IEnumerable<int> ^ source);public static int Max (this System.Collections.Generic.IEnumerable<int> source);static member Max : seq<int> -> int<Extension()>
Public Function Max (source As IEnumerable(Of Integer)) As Integer參數
- source
- IEnumerable<Int32>
要判斷最大值的 Int32 值序列。
傳回
序列中的最大值。
例外狀況
source 為 null。
source 沒有包含任何項目。
備註
方法Max(IEnumerable<Int32>)會使用的 IComparable<T> 實作Int32來比較值。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Decimal>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回 Decimal 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static System::Decimal Max(System::Collections::Generic::IEnumerable<System::Decimal> ^ source);public static decimal Max (this System.Collections.Generic.IEnumerable<decimal> source);static member Max : seq<decimal> -> decimal<Extension()>
Public Function Max (source As IEnumerable(Of Decimal)) As Decimal參數
- source
- IEnumerable<Decimal>
要判斷最大值的 Decimal 值序列。
傳回
序列中的最大值。
例外狀況
source 為 null。
source 沒有包含任何項目。
備註
方法Max(IEnumerable<Decimal>)會使用的 IComparable<T> 實作Decimal來比較值。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max(IEnumerable<Nullable<Decimal>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回可為 Null 之 Decimal 值序列中的最大值。
public:
[System::Runtime::CompilerServices::Extension]
static Nullable<System::Decimal> Max(System::Collections::Generic::IEnumerable<Nullable<System::Decimal>> ^ source);public static decimal? Max (this System.Collections.Generic.IEnumerable<decimal?> source);static member Max : seq<Nullable<decimal>> -> Nullable<decimal><Extension()>
Public Function Max (source As IEnumerable(Of Nullable(Of Decimal))) As Nullable(Of Decimal)參數
- source
- IEnumerable<Nullable<Decimal>>
要判斷最大值之可為 Null 的 Decimal 值序列。
傳回
C# 或 Nullable(Of Decimal) Visual Basic 中類型的Nullable<Decimal>值，對應至序列中的最大值。
例外狀況
source 為 null。
備註
方法Max(IEnumerable<Nullable<Decimal>>)會使用的 IComparable<T> 實作Decimal來比較值。
如果來源序列是空的，或只包含的值 null，則此函式會傳 null回 。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource,TResult>(IEnumerable<TSource>, Func<TSource,TResult>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在泛型序列的每個項目上叫用轉換函式，並傳回最大的結果值。
public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
static TResult Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TResult> ^ selector);public static TResult Max<TSource,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TResult> selector);public static TResult? Max<TSource,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TResult> selector);static member Max : seq<'Source> * Func<'Source, 'Result> -> 'Result<Extension()>
Public Function Max(Of TSource, TResult) (source As IEnumerable(Of TSource), selector As Func(Of TSource, TResult)) As TResult類型參數
- TSource
source 項目的類型。
- TResult
selector 所傳回值的型別。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
- selector
- Func<TSource,TResult>
要套用至每個項目的轉換函式。
傳回
序列中的最大值。
例外狀況
source 或 selector 為 null。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
如果類型 TResult 實作 ，這個方法會使用該實作 IComparable<T>來比較值。 否則，如果類型 TResult 實作 ，則會使用該實作 IComparable來比較值。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Single>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的 Single 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static float Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, float> ^ selector);public static float Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,float> selector);static member Max : seq<'Source> * Func<'Source, single> -> single<Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Single)) As Single類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
序列中的最大值。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法Max<TSource>(IEnumerable<TSource>, Func<TSource,Single>)會使用的 IComparable<T> 實作Single來比較值。
如果您提供函式 ， selector該函式會將 的成員 source 投影到數值類型，特別是 Single，您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的可為 Null 之 Single 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<float> Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<float>> ^ selector);public static float? Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,float?> selector);static member Max : seq<'Source> * Func<'Source, Nullable<single>> -> Nullable<single><Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Single))) As Nullable(Of Single)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
對應至序列中最大值的值。
例外狀況
source 或 selector 為 null。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Single>>)會使用的 IComparable<T> 實作Single來比較值。
如果您提供函selector式 ，可將 的成員source投影到 C# 或 Nullable(Of Single) Visual Basic 中的數值類型，Nullable<Single>您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的可為 Null 之 Int64 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<long> Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<long>> ^ selector);public static long? Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,long?> selector);static member Max : seq<'Source> * Func<'Source, Nullable<int64>> -> Nullable<int64><Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Long))) As Nullable(Of Long)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
對應至序列中最大值的值。
例外狀況
source 或 selector 為 null。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int64>>)會使用的 IComparable<T> 實作Int64來比較值。
如果您提供函selector式 ，可將 的成員source投影到 C# 或 Nullable(Of Int64) Visual Basic 中的數值類型，Nullable<Int64>您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的可為 Null 之 Int32 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<int> Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<int>> ^ selector);public static int? Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int?> selector);static member Max : seq<'Source> * Func<'Source, Nullable<int>> -> Nullable<int><Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Integer))) As Nullable(Of Integer)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
C# 或 Nullable(Of Int32) Visual Basic 中類型Nullable<Int32>的值，對應至序列中的最大值。
例外狀況
source 或 selector 為 null。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例使用方法的多載，與本文描述的特定多載不同。 若要將範例延伸至本文所描述的多載，請變更函 selector 式的主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Int32>>)會使用的 IComparable<T> 實作Int32來比較值。
如果您提供函selector式 ，可將 的成員source投影到 C# 或 Nullable(Of Int32) Visual Basic 中的數值類型，Nullable<Int32>您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中 Aggregate Into Max() ，子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的可為 Null 之 Decimal 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<System::Decimal> Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<System::Decimal>> ^ selector);public static decimal? Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,decimal?> selector);static member Max : seq<'Source> * Func<'Source, Nullable<decimal>> -> Nullable<decimal><Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Decimal))) As Nullable(Of Decimal)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
C# 或 Nullable(Of Decimal) Visual Basic 中類型Nullable<Decimal>的值，對應至序列中的最大值。
例外狀況
source 或 selector 為 null。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法 Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Decimal>>) 會 Decimal 使用的實作 IComparable<T> 來比較值。
如果您提供函式 ， selector可將 的成員 source 投影成數值類型，特別是 Nullable<Decimal> C# 或 Nullable(Of Decimal) Visual Basic 中的函式，您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的可為 Null 之 Double 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static Nullable<double> Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, Nullable<double>> ^ selector);public static double? Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,double?> selector);static member Max : seq<'Source> * Func<'Source, Nullable<double>> -> Nullable<double><Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Nullable(Of Double))) As Nullable(Of Double)類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
C# 或 Nullable(Of Double) Visual Basic 中類型Nullable<Double>的值，對應至序列中的最大值。
例外狀況
source 或 selector 為 null。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法 Max<TSource>(IEnumerable<TSource>, Func<TSource,Nullable<Double>>) 會 Double 使用的實作 IComparable<T> 來比較值。
如果您提供函式 ， selector可將 的成員 source 投影成數值類型，特別是 Nullable<Double> C# 或 Nullable(Of Double) Visual Basic 中的函式，您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的 Int32 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static int Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int> ^ selector);public static int Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int> selector);static member Max : seq<'Source> * Func<'Source, int> -> int<Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Integer)) As Integer類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
序列中的最大值。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 會 Int32 使用的實作 IComparable<T> 來比較值。
如果您提供函式 ， selector將 的成員 source 投影到數值類型，特別是 Int32，您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Double>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的 Double 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static double Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, double> ^ selector);public static double Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,double> selector);static member Max : seq<'Source> * Func<'Source, double> -> double<Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Double)) As Double類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
序列中的最大值。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法 Max<TSource>(IEnumerable<TSource>, Func<TSource,Double>) 會 Double 使用的實作 IComparable<T> 來比較值。
如果您提供函式 ， selector將 的成員 source 投影到數值類型，特別是 Double，您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的 Decimal 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Decimal Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, System::Decimal> ^ selector);public static decimal Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,decimal> selector);static member Max : seq<'Source> * Func<'Source, decimal> -> decimal<Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Decimal)) As Decimal類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
序列中的最大值。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法 Max<TSource>(IEnumerable<TSource>, Func<TSource,Decimal>) 會 Decimal 使用的實作 IComparable<T> 來比較值。
如果您提供函式 ， selector將 的成員 source 投影到數值類型，特別是 Decimal，您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, IComparer<TSource>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回泛型序列中的最大值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource Max(System::Collections::Generic::IEnumerable<TSource> ^ source, System::Collections::Generic::IComparer<TSource> ^ comparer);public static TSource? Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, System.Collections.Generic.IComparer<TSource>? comparer);static member Max : seq<'Source> * System.Collections.Generic.IComparer<'Source> -> 'Source<Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), comparer As IComparer(Of TSource)) As TSource類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
- comparer
- IComparer<TSource>
用來比較值的 IComparer<T>。
傳回
序列中的最大值。
例外狀況
source 為 null。
source 中沒有任何物件實作 IComparable 或 IComparable<T> 介面。
備註
如果類型 TSource 實作 IComparable<T>，則 Max<TSource>(IEnumerable<TSource>) 方法會使用該實作來比較值。 否則，如果類型 TSource 實作 IComparable，則會使用該實作來比較值。
如果 TSource 參考型別，而且來源序列是空的，或只包含的值 null，則這個方法會傳 null回 。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
適用於
Max<TSource>(IEnumerable<TSource>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
傳回泛型序列中的最大值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource Max(System::Collections::Generic::IEnumerable<TSource> ^ source);public static TSource Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);public static TSource? Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);static member Max : seq<'Source> -> 'Source<Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource)) As TSource類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
序列中的最大值。
例外狀況
source 為 null。
source 中沒有任何物件實作 IComparable 或 IComparable<T> 介面。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>) 來判斷物件序列 IComparable<T> 中的最大值。
/// <summary>
/// This class implements IComparable to be able to
/// compare one Pet to another Pet.
/// </summary>
class Pet : IComparable<Pet>
{
public string Name { get; set; }
public int Age { get; set; }
/// <summary>
/// Compares this Pet to another Pet by
/// summing each Pet's age and name length.
/// </summary>
/// <param name="other">The Pet to compare this Pet to.</param>
/// <returns>-1 if this Pet is 'less' than the other Pet,
/// 0 if they are equal,
/// or 1 if this Pet is 'greater' than the other Pet.</returns>
int IComparable<Pet>.CompareTo(Pet other)
{
int sumOther = other.Age + other.Name.Length;
int sumThis = this.Age + this.Name.Length;
if (sumOther > sumThis)
return -1;
else if (sumOther == sumThis)
return 0;
else
return 1;
}
}
public static void MaxEx3()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
Pet max = pets.Max();
Console.WriteLine(
"The 'maximum' animal is {0}.",
max.Name);
}
/*
This code produces the following output:
The 'maximum' animal is Barley.
*/
' This class implements IComparable
' and has a custom 'CompareTo' implementation.
Class Pet
Implements IComparable(Of Pet)
Public Name As String
Public Age As Integer
''' <summary>
''' Compares Pet objects by the sum of their age and name length.
''' </summary>
''' <param name="other">The Pet to compare this Pet to.</param>
''' <returns>-1 if this Pet's sum is 'less' than the other Pet,
''' 0 if they are equal,
''' or 1 if this Pet's sum is 'greater' than the other Pet.</returns>
Function CompareTo(ByVal other As Pet) As Integer _
Implements IComparable(Of Pet).CompareTo
If (other.Age + other.Name.Length > Me.Age + Me.Name.Length) Then
Return -1
ElseIf (other.Age + other.Name.Length = Me.Age + Me.Name.Length) Then
Return 0
Else
Return 1
End If
End Function
End Class
Sub MaxEx3()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Find the "maximum" pet according to the
' custom CompareTo() implementation.
Dim max As Pet = pets.Max()
' Display the result.
Console.WriteLine($"The 'maximum' animal is {max.Name}")
End Sub
' This code produces the following output:
'
' The 'maximum' animal is Barley
備註
如果類型 TSource 實作 IComparable<T>，則 Max<TSource>(IEnumerable<TSource>) 方法會使用該實作來比較值。 否則，如果類型 TSource 實作 IComparable，則會使用該實作來比較值。
如果 TSource 參考型別，而且來源序列是空的，或只包含的值 null，則這個方法會傳 null回 。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
另請參閱
適用於
Max<TSource>(IEnumerable<TSource>, Func<TSource,Int64>)
- 來源:
- Max.cs
- 來源:
- Max.cs
- 來源:
- Max.cs
在序列的每個項目上叫用轉換函式，並傳回最大的 Int64 值。
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static long Max(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, long> ^ selector);public static long Max<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,long> selector);static member Max : seq<'Source> * Func<'Source, int64> -> int64<Extension()>
Public Function Max(Of TSource) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Long)) As Long類型參數
- TSource
source 項目的類型。
參數
- source
- IEnumerable<TSource>
要判斷最大值的值序列。
傳回
序列中的最大值。
例外狀況
source 或 selector 為 null。
source 沒有包含任何項目。
範例
下列程式代碼範例示範如何使用 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int32>) 來判斷投影值序列中的最大值。
注意
此程式代碼範例會使用與本文所描述之特定多載不同的 方法多載。 若要將範例擴充至本文所描述的多載，請變更函式的 selector 主體。
class Pet
{
public string Name { get; set; }
public int Age { get; set; }
}
public static void MaxEx4()
{
Pet[] pets = { new Pet { Name="Barley", Age=8 },
new Pet { Name="Boots", Age=4 },
new Pet { Name="Whiskers", Age=1 } };
int max = pets.Max(pet => pet.Age + pet.Name.Length);
Console.WriteLine(
"The maximum pet age plus name length is {0}.",
max);
}
/*
This code produces the following output:
The maximum pet age plus name length is 14.
*/
Structure Pet
Public Name As String
Public Age As Integer
End Structure
Sub MaxEx4()
' Create an array of Pet objects.
Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
New Pet With {.Name = "Boots", .Age = 4},
New Pet With {.Name = "Whiskers", .Age = 1}}
' Determine the "maximum" pet by passing a
' lambda expression to Max() that sums the pet's age
' and name length.
Dim max As Integer = pets.Max(Function(pet) _
pet.Age + pet.Name.Length)
' Display the result.
Console.WriteLine($"The maximum pet age plus name length is {max}")
End Sub
' This code produces the following output:
'
' The maximum pet age plus name length is 14
備註
方法 Max<TSource>(IEnumerable<TSource>, Func<TSource,Int64>) 會 Int64 使用的實作 IComparable<T> 來比較值。
如果您提供函式 ， selector將 的成員 source 投影到數值類型，特別是 Int64，您可以將這個方法套用至任意值的序列。
在 Visual Basic 查詢表達式語法中， Aggregate Into Max() 子句會轉譯為的 Max調用。
