Mono Class Library: System.Array Overview | Members

System.Array.Sort Method

Sorts the specified ranges of the specified pair of one-dimensional Array objects (one containing a set of keys and the other containing corresponding items) based on the keys in the first specified Array. [Edit]

[System.Runtime.ConstrainedExecution.ReliabilityContract(System.Runtime.ConstrainedExecution.Consistency.MayCorruptInstance, System.Runtime.ConstrainedExecution.Cer.MayFail)]
public static void Sort (Array keys, Array items, int index, int length)

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]
index
A int that contains the index at which sort begins. [Edit]
length
A int that contains the number of elements to sort. [Edit]

Exceptions

TypeReason
ArgumentNullExceptionkeys is null. [Edit]
RankException

keys has more than one dimension.

-or-

items is not a null reference and has more than one dimension.

[Edit]
ArgumentOutOfRangeException

index < keys.GetLowerBound(0).

-or-

length < 0.

[Edit]
ArgumentException

items is not a null reference, and keys.GetLowerBound(0) does not equal items.GetLowerBound(0).

-or-

index and length do not specify a valid range in keys.

-or-

items is not a null reference, and index and length do not specify a valid range in items.

[Edit]
InvalidOperationExceptionOne 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, index, length, null).

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. Therefore, items is sorted according to the arrangement of the corresponding keys in keys. If the sort is not successfully completed, the results are undefined.

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