Array Class

Provides methods for manipulating arrays.This class is the base class for all arrays. This class cannot be inherited.

Definition

public sealed class Array: Object, ICloneable, ICollection, IEnumerable, IList

Members Table

The following table lists the members exposed by the Array object. Click a tab on the left to choose the type of member you want to view.

Methods

Method	Description
Add	When implemented by a class, adds an item to the IList. (Inherited from IList)
BinarySearch	Overloaded. Searches for a value in the sorted Array, using a binary search algorithm.
Clear	Overloaded. (Inherited from IList)
Clone	Creates a shallow copy of the Array.
Contains	When implemented by a class, determines whether the IList contains a specific value. (Inherited from IList)
Copy	Overloaded. Copies a section of one Array to another Array.
CopyTo	Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array at the specified index.
Equals	Overloaded. Compares two objects to determine if they are equal. (Inherited from Object)
Fill	Overloaded. Fills an Array with a specified Object.
GetEnumerator	Returns an IEnumerator for the Array.
GetHashCode	Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. (Inherited from Object)
GetLength	Gets the number of elements in the Array.
GetType	Gets the Type of the current instance. (Inherited from Object)
GetValue	Gets the value at the specified position in the one-dimensional Array.
IndexOf	Overloaded. (Inherited from IList)
Insert	When implemented by a class, inserts an item to the IList at the specified position. (Inherited from IList)
LastIndexOf	Overloaded. Returns the index of the last occurrence of a value in an array or in a part of the Array.
ReferenceEquals	Determines whether the specified Object instances are the same instance. (Inherited from Object)
Remove	When implemented by a class, removes the first occurrence of a specific object from the IList. (Inherited from IList)
RemoveAt	When implemented by a class, removes the IList item at the specified index. (Inherited from IList)
Resize	Overloaded. Changes the size of an array to the specified new size.
ResizeArray	Changes the size of an array to the specified new size.
Reverse	Overloaded. Reverses the order of the elements in a one-dimensional Array or in a part of the Array.
SetValue	Sets a value to the specified element in the one-dimensional Array.
Sort	Overloaded. Sorts the elements in the Array objects.
SwapElements	Swaps two elements base on the indexes of the Array.
System.Collections.IList.Add	Always throws an exception.
System.Collections.IList.Clear	Sets all elements in the Array to zero, to false, or to a null reference.
System.Collections.IList.Contains	Determines whether an element is in the Array.
System.Collections.IList.IndexOf	Searches for the specified object and returns the index of the first occurrence within the current instance.
System.Collections.IList.Insert	Always throws an exception.
System.Collections.IList.Remove	Always throws an exception.
System.Collections.IList.RemoveAt	Always throws an exception.
System.Collections.IList.this[]	Gets or sets the value to the Array at the specified index.
ToString	Overriden. Returns a String that represents the current Object.
this[]	When implemented by a class, gets or sets an item to the IList. (Inherited from IList)

Properties

Property	Description
Count	Gets the number of elements contained by the ICollection. (Inherited from ICollection)
IsFixedSize	Gets a value indicating whether the Array has a fixed size.
IsReadOnly	Gets a value indicating whether the Array is read-only.
IsSynchronized	Gets a value indicating whether access to the Array is synchronized.
Length	Gets the total number of elements in the Array.
Rank	Gets the rank of the Array.
SyncRoot	Gets an object that can be used to synchronize access to the Array.
System.Collections.ICollection.Count	The number of the elements that contained in the ICollection.

Inheritance Hierarchy

Object

Array

Remarks

Multidimensional arrays are not supported.

Examples

Copy Code to Clipboard

// This sample shows how to implement the Array. It also shows some methods that use for the Array.

 

using System;

using System.Diagnostics;

 

public class SampleArray

{

     static void Main()

     {

          // Creates and initializes a new integer array and a new object array.

          int[] myIntArray = new int[5]{30,25,20,15,10};

          object[] myObjectArray = new object[7]{4,5,1,2,3,7,6};

 

          // Displays the integer and object arrays.

          Debug.WriteLine(" Before sorting");

          Debug.Write("\t Integer array: ");

          DisplayArray(myIntArray);

          Debug.Write("\n\t Object array: \t");

          DisplayArray(myObjectArray);

 

          // Uses the sorting method.

          Array.Sort(myIntArray);

          Array.Sort(myObjectArray);

 

          // Displays the integer and object arrays.

          Debug.Write("\n\n After sorting");

          Debug.Write("\n\t Integer array: ");

          DisplayArray(myIntArray);

          Debug.Write("\n\t Object array: \t");

          DisplayArray(myObjectArray);

 

          // Copies myIntArray to myObjectArray starting at third index.

          myIntArray.CopyTo(myObjectArray, 2);

 

          // Displays the integer and object arrays.

          Debug.Write("\n\n After copying");

          Debug.Write("\n\t Integer array: ");

          DisplayArray(myIntArray);

          Debug.Write("\n\t Object array: \t");

          DisplayArray(myObjectArray);

 

          // Reverses the integer array.

          Array.Reverse(myIntArray);

          Array.Reverse(myObjectArray);

 

          // Displays the integer and object arrays.

          Debug.Write("\n\n After reversing");

          Debug.Write("\n\t Integer array: ");

          DisplayArray(myIntArray);

          Debug.Write("\n\t Object array: \t");

          DisplayArray(myObjectArray);

     }

 

     static void DisplayArray( int[] myArray )

     {

          for(int i = 0; i < myArray.Length; i++)

          {

               Debug.Write(myArray[i] + "\t");

          }

     }

     static void DisplayArray( object[] myArray )

     {

          for(int i = 0; i < myArray.Length; i++)

          {

               Debug.Write(myArray[i] + "\t");

          }

     }

}

 

/*

The output of the sample.

 

Before sorting

     Integer array: 30 25 20 15 10

     Object array:  4 5 1 2 3 7 6

 

After sorting

     Integer array: 10 15 20 25 30

     Object array:  1 2 3 4 5 6 7

 

After copying

     Integer array: 10 15 20 25 30

     Object array:  1 2 10 15 20 25 30

 

After reversing

     Integer array: 30 25 20 15 10

     Object array:  30 25 20 15 10 2 1

 

*/

Class Information

Namespace	System
Flash Library	corlib.scl
Flash Library Version	2.0.0.2466
Silverlight Library	System.Windows.Forms.dll