Item-Eigenschaft (Collection-Objekt)

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt ein bestimmtes Element eines Collection-Objekts über die Position oder den Schlüssel zurück. Schreibgeschützt.

Default Public ReadOnly Property Item( _
    ByVal { Key As String | Index As Integer | Index As Object } _
) As Object

Parameter

Key
Ein eindeutiger String-Ausdruck, der eine Schlüsselzeichenfolge angibt, die anstelle eines Positionsindexes verwendet wird, um auf ein Element der Auflistung zuzugreifen. Key muss dem Key-Argument entsprechen, das beim Hinzufügen des Elements zur Auflistung angegeben wurde.
Index
(A) Ein numerischer Ausdruck, der die Position eines Elements der Auflistung angibt. Index muss eine Zahl von 1 bis zu dem Wert der Count-Eigenschaft (Collection-Objekt) der Auflistung sein. Oder (B) Ein Object-Ausdruck, der die Position oder Schlüsselzeichenfolge eines Elements der Auflistung angibt.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Key ist ungültig oder stimmt nicht mit einem vorhandenen Element der Auflistung überein. Index kann nicht als Zeichen oder numerische Daten interpretiert werden.
IndexOutOfRangeException	9	Key ist Nothing. Index stimmt mit keinem bereits vorhandenen Element der Auflistung überein.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Wenn Index vom Typ Object ist, versucht die Item-Eigenschaft, Index als String, als Char, als Char-Array oder als ganze Zahl zu behandeln. Wenn Index von Item nicht in String oder Integer konvertiert werden kann, wird eine ArgumentException-Ausnahme ausgelöst.

Die Item-Eigenschaft ist die Standardeigenschaft für eine Auflistung. Die folgenden Codezeilen sind daher gleichwertig.

MsgBox(CStr(customers.Item(1)))
MsgBox(CStr(customers(1)))

Beispiel

Im folgenden Beispiel wird mit der Item-Eigenschaft ein Verweis auf ein Objekt in einer Auflistung abgerufen. Sie erstellt birthdays als ein Collection-Objekt und ruft anschließend das Objekt, das Bills Geburtstag darstellt, mit dem "Bill"-Schlüssel als Index-Argument ab.

Dim birthdays As New Collection()
birthdays.Add(New DateTime(2001, 1, 12), "Bill")
birthdays.Add(New DateTime(2001, 1, 13), "Joe")
birthdays.Add(New DateTime(2001, 1, 14), "Mike")
birthdays.Add(New DateTime(2001, 1, 15), "Pete")


...


Dim aBirthday As DateTime
aBirthday = birthdays.Item("Bill")
MsgBox(CStr(aBirthday))
aBirthday = birthdays("Bill")
MsgBox(CStr(aBirthday))

Der erste Aufruf gibt die Item-Eigenschaft explizit an, der zweite nicht. Beide Aufrufe funktionieren, da die Item-Eigenschaft die Standardeigenschaft für ein Collection-Objekt ist.