Collection.Item[] Eigenschaft

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Ruft ein bestimmtes Element eines Collection-Objekts entweder nach Position oder nach Schlüssel ab.

Überlädt

Item[Int32]	Ruft ein bestimmtes Element eines Collection-Objekts entweder nach Position oder nach Schlüssel ab.
Item[Object]	Ruft ein bestimmtes Element eines Collection-Objekts entweder nach Position oder nach Schlüssel ab.
Item[String]	Ruft ein bestimmtes Element eines Collection-Objekts entweder nach Position oder nach Schlüssel ab.

Item[Int32]

Quelle:

Collection.vb

Ruft ein bestimmtes Element eines Collection-Objekts entweder nach Position oder nach Schlüssel ab.

public:
 property System::Object ^ default[int] { System::Object ^ get(int Index); };

public object? this[int Index] { get; }

member this.Item(int) : obj

Default Public ReadOnly Property Item(Index As Integer) As Object

Parameter

Index

Int32

Ein numerischer Ausdruck, der die Position eines Elements der Auflistung angibt. Index muss eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung sein. Oder (B) Ein Object-Ausdruck, der die Position oder Schlüsselzeichenfolge eines Elements der Auflistung angibt.

Eigenschaftswert

Object

Ein bestimmtes Element eines Collection Objekts entweder nach Position oder nach Taste.

Beispiele

Im folgenden Beispiel wird die Item -Eigenschaft verwendet, um einen Verweis auf ein Objekt in einer Auflistung abzurufen. Es wird als Objekt erstellt birthdays und dann das Objekt abgerufen, das Bills Geburtstag darstellt, wobei der Schlüssel "Bill" als Index Argument verwendet Collection wird.

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))

Beachten Sie, dass der erste Aufruf die Item Eigenschaft explizit angibt, der zweite jedoch nicht. Beide rufen Arbeit auf, da die Item -Eigenschaft die Standardeigenschaft für ein Collection -Objekt ist.

Hinweise

Wenn Index vom Typ Objectist, versucht die Item Eigenschaft, sie als String, , Chararray Char oder ganzzahligen Wert zu behandeln. Wenn Item keine Konvertierung Index in String oder möglich Integerist, wird eine ArgumentException Ausnahme ausgelöst.

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

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

Item[Object]

Quelle:

Collection.vb

Ruft ein bestimmtes Element eines Collection-Objekts entweder nach Position oder nach Schlüssel ab.

public:
 property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ Index); };

public object? this[object Index] { get; }

member this.Item(obj) : obj

Default Public ReadOnly Property Item(Index As Object) As Object

Parameter

Index

Object

Ein numerischer Ausdruck, der die Position eines Elements der Auflistung angibt. Index muss eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung sein. Oder (B) Ein Object-Ausdruck, der die Position oder Schlüsselzeichenfolge eines Elements der Auflistung angibt.

Eigenschaftswert

Object

Ein bestimmtes Element eines Collection Objekts entweder nach Position oder nach Taste.

Beispiele

Im folgenden Beispiel wird die Item -Eigenschaft verwendet, um einen Verweis auf ein Objekt in einer Auflistung abzurufen. Es wird als Objekt erstellt birthdays und dann das Objekt abgerufen, das Bills Geburtstag darstellt, wobei der Schlüssel "Bill" als Index Argument verwendet Collection wird.

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))

Beachten Sie, dass der erste Aufruf die Item Eigenschaft explizit angibt, der zweite jedoch nicht. Beide rufen Arbeit auf, da die Item -Eigenschaft die Standardeigenschaft für ein Collection -Objekt ist.

Hinweise

Wenn Index vom Typ Objectist, versucht die Item Eigenschaft, sie als String, , Chararray Char oder ganzzahligen Wert zu behandeln. Wenn Item keine Konvertierung Index in String oder möglich Integerist, wird eine ArgumentException Ausnahme ausgelöst.

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

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

Item[String]

Quelle:

Collection.vb

Ruft ein bestimmtes Element eines Collection-Objekts entweder nach Position oder nach Schlüssel ab.

public:
 property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ Key); };

public object? this[string Key] { get; }

member this.Item(string) : obj

Default Public ReadOnly Property Item(Key As String) As Object

Parameter

Key

String

Ein eindeutiger String-Ausdruck, der eine Schlüsselzeichenfolge angibt, die anstelle eines Positionsindex verwendet werden kann, um auf ein Element der Auflistung zuzugreifen. Key muss dem Key-Argument entsprechen, das beim Hinzufügen des Elements zur Auflistung angegeben wurde.

Eigenschaftswert

Object

Ein bestimmtes Element eines Collection Objekts entweder nach Position oder nach Taste.

Beispiele

Im folgenden Beispiel wird die Item -Eigenschaft verwendet, um einen Verweis auf ein Objekt in einer Auflistung abzurufen. Es wird als Objekt erstellt birthdays und dann das Objekt abgerufen, das Bills Geburtstag darstellt, wobei der Schlüssel "Bill" als Index Argument verwendet Collection wird.

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))

Beachten Sie, dass der erste Aufruf die Item Eigenschaft explizit angibt, der zweite jedoch nicht. Beide rufen Arbeit auf, da die Item -Eigenschaft die Standardeigenschaft für ein Collection -Objekt ist.

Hinweise

Wenn Index vom Typ Objectist, versucht die Item Eigenschaft, sie als String, , Chararray Char oder ganzzahligen Wert zu behandeln. Wenn Item keine Konvertierung Index in String oder möglich Integerist, wird eine ArgumentException Ausnahme ausgelöst.

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

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