Array.Clear Method

Sets a range of elements in the Array to zero, to false, or to a null reference (Nothing in Visual Basic), depending on the element type.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public static void Clear (
	Array array,
	int index,
	int length
public static void Clear (
	Array array, 
	int index, 
	int length
public static function Clear (
	array : Array, 
	index : int, 
	length : int



The Array whose elements need to be cleared.


The starting index of the range of elements to clear.


The number of elements to clear.

Exception typeCondition


array is a null reference (Nothing in Visual Basic).


index is less than the lower bound of array.


length is less than zero.


The sum of index and length is greater than the size of the Array.

Reference-type elements are set to a null reference (Nothing in Visual Basic). Boolean-type elements are set to false. Other value-type elements are set to zero.

This method only clears the values of the elements; it does not delete the elements themselves. An Array has a fixed size; therefore, elements cannot be added or removed.

This method is an O(n) operation, where n is length.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0