Parameters

keys

A one-dimensional Array that contains the keys to sort. [Edit]

items

A one-dimensional Array that contains the items that correspond to each element in keys. Specify a null reference to sort only keys. [Edit]

comparer

The IComparer implementation to use when comparing elements. Specify a null reference to use the IComparable implementation of each element. [Edit]

Exceptions

Type	Reason
ArgumentNullException	keys is null. [Edit]
RankException	keys has more than one dimension. -or- items is not a null reference and has more than one dimension. [Edit]
ArgumentException	items is not a null reference, and keys.GetLowerBound(0) does not equal items.GetLowerBound(0). -or- items is not a null reference, and keys.Length > items.Length. [Edit]
InvalidOperationException	comparer is a null, and one or more elements in keys that are used in a comparison do not implement the IComparable interface. [Edit]

Remarks

This version of Array.Sort(Array) is equivalent to Array.Sort(Array)(keys, items, keys.GetLowerBound(0), keys.Length, comparer).

Each key in keys is required to have a corresponding item in items. The sort is performed according to the order of keys . After a key is repositioned during the sort, the corresponding item in items is similarly repositioned. Only keys.Length elements of items are sorted. Therefore, items is sorted according to the arrangement of the corresponding keys in keys. If the sort is not successfully completed, the results are unspecified.

If comparer is a null reference, each element of keys is required to implement the IComparable interface to be capable of comparisons with every other element in keys.

[Edit]

Requirements

Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0