System.Array.Sort 方法 (Array, Array, IComparer)
方法描述
基于第一个 Array 中的关键字,使用指定的 IComparer,对两个一维 Array 对象(一个包含关键字,另一个包含对应的项)进行排序。
语法定义(C# System.Array.Sort 方法 (Array, Array, IComparer) 的用法)
public static void Sort( Array keys, Array items, IComparer comparer )
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
keys | System-Array | 一维 Array,它包含要排序的关键字。 |
items | System-Array | 一维 Array,其中包含与 keysArray 中每个键对应的项。- 或 -null 则只对 keysArray 进行排序。 |
comparer | System-Collections-IComparer | 比较元素时要使用的 IComparer 实现。- 或 -若为 null,则使用每个元素的 IComparable 实现。 |
返回值 | void |
提示和注释
keys Array 中的每个关键字在 itemsArray 中都有对应项。 当关键字在排序过程中重新定位时,itemsArray 中的对应项也同样重新定位。 因此,itemsArray 根据 keysArray 中对应关键字的排列进行排序。
如果 comparer 为 null,则 keysArray 中的每个关键字均必须实现 IComparable 接口,才能与其他所有关键字进行比较。
如果项数多于键数,您仍可以进行排序,但没有对应的键的项将不会被排序。 如果键数多于项数,您不能进行排序,这样做会引发 ArgumentException。
如果排序不能成功地完成,则结果未定义。
此方法使用 QuickSort 算法。 此实现执行不稳定排序;亦即,如果两元素相等,则其顺序可能不被保留。 相反,稳定排序则会保持相等元素的顺序。
一般情况下,此方法的运算复杂度为 O(n log n),其中 n 是 keys 的 Length;最坏的情况下其运算复杂度为 O(n ^ 2)。
System.Array.Sort 方法 (Array, Array, IComparer)例子
请注意,结果可能因当前 CultureInfo 而异。
using System; using System.Collections; public class SamplesArray { public class myReverserClass : IComparer { // Calls CaseInsensitiveComparer.Compare with the parameters reversed. int IComparer.Compare( Object x, Object y ) { return( (new CaseInsensitiveComparer()).Compare( y, x ) ); } } public static void Main() { // Creates and initializes a new Array and a new custom comparer. String[] myKeys = { "red", "GREEN", "YELLOW", "BLUE", "purple", "black", "orange" }; String[] myValues = { "strawberries", "PEARS", "LIMES", "BERRIES", "grapes", "olives", "cantaloupe" }; IComparer myComparer = new myReverserClass(); // Displays the values of the Array. Console.WriteLine( "The Array initially contains the following values:" ); PrintKeysAndValues( myKeys, myValues ); // Sorts a section of the Array using the default comparer. Array.Sort( myKeys, myValues, 1, 3 ); Console.WriteLine( "After sorting a section of the Array using the default comparer:" ); PrintKeysAndValues( myKeys, myValues ); // Sorts a section of the Array using the reverse case-insensitive comparer. Array.Sort( myKeys, myValues, 1, 3, myComparer ); Console.WriteLine( "After sorting a section of the Array using the reverse case-insensitive comparer:" ); PrintKeysAndValues( myKeys, myValues ); // Sorts the entire Array using the default comparer. Array.Sort( myKeys, myValues ); Console.WriteLine( "After sorting the entire Array using the default comparer:" ); PrintKeysAndValues( myKeys, myValues ); // Sorts the entire Array using the reverse case-insensitive comparer. Array.Sort( myKeys, myValues, myComparer ); Console.WriteLine( "After sorting the entire Array using the reverse case-insensitive comparer:" ); PrintKeysAndValues( myKeys, myValues ); } public static void PrintKeysAndValues( String[] myKeys, String[] myValues ) { for ( int i = 0; i < myKeys.Length; i++ ) { Console.WriteLine( " {0,-10}: {1}", myKeys[i], myValues[i] ); } Console.WriteLine(); } } /* This code produces the following output. The Array initially contains the following values: red : strawberries GREEN : PEARS YELLOW : LIMES BLUE : BERRIES purple : grapes black : olives orange : cantaloupe After sorting a section of the Array using the default comparer: red : strawberries BLUE : BERRIES GREEN : PEARS YELLOW : LIMES purple : grapes black : olives orange : cantaloupe After sorting a section of the Array using the reverse case-insensitive comparer: red : strawberries YELLOW : LIMES GREEN : PEARS BLUE : BERRIES purple : grapes black : olives orange : cantaloupe After sorting the entire Array using the default comparer: black : olives BLUE : BERRIES GREEN : PEARS orange : cantaloupe purple : grapes red : strawberries YELLOW : LIMES After sorting the entire Array using the reverse case-insensitive comparer: YELLOW : LIMES red : strawberries purple : grapes orange : cantaloupe GREEN : PEARS BLUE : BERRIES black : olives */
异常
异常 | 异常描述 |
---|---|
ArgumentNullException | keys 为 null。 |
RankException |
|
ArgumentException |
|
InvalidOperationException | comparer 为 null,并且 keysArray 中的一个或多个元素不实现 IComparable 接口。 |
版本信息
.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。