Gewusst wie: Hinzufügen, Löschen und Abrufen von Elementen einer Auflistung

Artikel
09/02/2008

Aktualisiert: November 2007

Die Collection-Klasse von Visual Basic enthält integrierte Funktionen, die es Ihnen ermöglichen, Elemente hinzuzufügen, zu löschen und abzurufen.

Sobald ein Element neu erstellt oder abgerufen wurde, etwa ein neuer Kunde, sollten Sie es einer Auflistung hinzufügen.
Sie sollten ein Element aus einer Auflistung entfernen, wenn es nicht mehr in die Auflistung gehört, beispielsweise wenn ein Mitarbeiter die Firma verlässt.
Sie sollten ein Element aus einer Auflistung abrufen, um es bearbeiten zu können, z. B. um die Telefonnummer eines Studenten zu ändern.

Hinweis:
Collection-Objekte aktualisieren ihre numerischen Indexnummern automatisch, sobald Sie Elemente hinzufügen und löschen. Deswegen kann sich der numerische Index eines gegebenen Elements oft ändern. Sie können daher einen numerischen Indexwert nicht speichern und erwarten, dass dieser an anderer Stelle im Programm dasselbe Element abruft. Verwenden Sie zu diesem Zweck Schlüssel.

So fügen Sie ein Element einer Auflistung hinzu

Verwenden Sie dasAdd-Methode (Collection-Objekt), und geben Sie das Element durch seinen Key an.

object.Add(Item, Key [, {Before | After}])

So können Sie beispielsweise mit folgendem Aufruf ein Auftragsobjekt unter Verwendung der ID-Eigenschaft des Auftrags als Schlüssel einer Auftragsauflistung hinzufügen:
```
workOrders.Add(woNew, woNew.ID)
```
Im vorherigen Aufruf wird davon ausgegangen, dass die ID-Eigenschaft eine Zeichenfolge ist. Wenn das Auftragsobjekt eine Zahl ist (beispielsweise eine ganze Zahl vom Typ Long), konvertieren Sie sie mit der Methode ToString in den String-Wert, der für das Key-Argument erforderlich ist.
```
workOrders.Add(woNew, woNew.ID.ToString())
```
Die Verwendung eines Schlüssels ist optional. Wenn Sie dem Objekt in der Auflistung keinen Schlüsselwert zuordnen möchten, können Sie es ohne Schlüsselwert hinzufügen.
```
workOrders.Add(woNew)
```
Sie können das optionale Before-Argument und das optionale After-Argument verwenden, um eine geordnete Auflistung von Objekten zu verwalten. Das hinzuzufügende Element wird in der Auflistung vor oder nach dem Element eingefügt, das durch das Before-Argument bzw. das After-Argument gekennzeichnet wird. Wenn Sie beispielsweise für Before den Wert 1 angeben, wird das Element am Beginn der Auflistung eingefügt, weil die Indizierung der Elemente von Collection-Objekten mit 1 beginnt.
```
workOrders.Add(woNew, woNew.ID, 1)
```
Ebenso wird durch die Angabe des After-Arguments ein Element nach dem angegebenen Index eingefügt. Im folgenden Beispiel wird ein Element als drittes Element eingefügt:
```
workOrders.Add(woNew, woNew.ID,,2)
```
Sie können einen Wert für Before oder After angeben, jedoch nicht für beide Argumente gleichzeitig.

So löschen Sie ein Element aus einer Auflistung

Verwenden Sie die Remove-Methode (Collection-Objekt), und geben Sie das Element entweder durch seinen Index oder seinen Key an.

object.Remove({Index | Key})

Das Index-Argument ist die Position des Elements, das Sie löschen möchten. Das Key-Argument ist dieselbe Zeichenfolge, die Sie zum Hinzufügen des Elements zur Auflistung verwendet haben. Wenn der Schlüssel des dritten Elements einer Auflistung "W017493" lautet, können Sie es mit einer der beiden folgenden Anweisungen löschen:
```
workOrders.Remove(3)
workOrders.Remove("W017493")
```

So löschen Sie alle Elemente aus einer Auflistung

Verwenden Sie die Clear-Methode (Collection-Objekt).

object.Clear()

Die Clear-Methode löscht sämtliche Elemente der Auflistung.

So rufen Sie ein Element aus einer Auflistung ab

Verwenden Sie die Item-Eigenschaft (Collection-Objekt), und geben Sie das Element entweder durch seinen Index oder seinen Key an.

variable = object.Item({Index | Key})

Wie bei der Remove-Methode ist das Index-Argument die Position des Elements in der Auflistung. Das Key-Argument ist die Zeichenfolge, die zum Hinzufügen des Elements verwendet wurde. Bei Verwendung desselben Beispiels wie für die Remove-Methode wird durch jede der folgenden Anweisungen das dritte Element der Auflistung abgerufen:

woCurrent = workOrders.Item(3)
woCurrent = workOrders.Item("W017493")

Hinweis:
Wenn Sie Zahlen als Schlüssel verwenden, müssen Sie sie mithilfe ihrer ToString-Methoden in Zeichenfolgen umwandeln, bevor Sie sie der Add-Methode, der Remove-Methode oder der Item-Eigenschaft übergeben. In Visual Basic wird bei einem Collection-Objekt stets davon ausgegangen, dass es sich bei einer Zahl um den Index und nicht um eine Schlüsselzeichenfolge handelt.

Wenn Sie den Schlüssel zur Kompilierungszeit kennen, können Sie stattdessen mithilfe des Operators für den Dictionary-Zugriff (!) auf ein Element der Auflistung zugreifen, ohne den Schlüssel in Anführungszeichen oder runde Klammern einzuschließen. Der vorherige Aufruf könnte auch wie folgt formuliert werden.
```
woCurrent = workOrders!W017493
```