Export (0) Print
Expand All

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
)

Parameters

array

The Array whose elements need to be cleared.

index

The starting index of the range of elements to clear.

length

The number of elements to clear.

Exception typeCondition

ArgumentNullException

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

IndexOutOfRangeException

index is less than the lower bound of array.

-or-

length is less than zero.

-or-

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

Community Additions

ADD
Show:
© 2014 Microsoft