Array.Clear-Methode

Legt einen Bereich von Elementen des Array je nach Elementtyp auf 0, false oder NULL (Nothing in Visual Basic) fest.

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

Syntax

'Declaration
Public Shared Sub Clear ( _
    array As Array, _
    index As Integer, _
    length As Integer _
)
'Usage
Dim array As Array
Dim index As Integer
Dim length As Integer

Array.Clear(array, index, length)

public static void Clear (
    Array array,
    int index,
    int length
)

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
)

Parameter

• array
  Das Array, dessen Elemente gelöscht werden sollen.

• index
  Der Startindex für den Bereich der zu löschenden Elemente.

• length
  Die Anzahl der zu löschenden Elemente.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	array ist NULL (Nothing in Visual Basic).
IndexOutOfRangeException	index ist kleiner als die untere Grenze von array. - oder - length ist kleiner als 0. - oder - Die Summe von index und length ist größer als die Länge des Array.

Hinweise

Elemente mit Verweistyp werden auf NULL (Nothing in Visual Basic) festgelegt. Elemente mit booleschem Typ werden auf false festgelegt. Andere Werttypen werden auf 0 festgelegt.

Diese Methode löscht nur die Werte der Elemente. Sie löscht nicht die Elemente selbst. Ein Array hat eine feste Größe. Daher können Elemente weder hinzugefügt noch entfernt werden.

Diese Methode ist eine O(n)-Operation, wobei nlength ist.

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Array-Klasse
Array-Member
System-Namespace
ICollection.Count