Collection.Item[] 属性

定义

命名空间:

Microsoft.VisualBasic

程序集:

Microsoft.VisualBasic.Core.dll

按位置或键获取 Collection 对象的特定元素。

重载

Item[Int32]	按位置或键获取 Collection 对象的特定元素。
Item[Object]	按位置或键获取 Collection 对象的特定元素。
Item[String]	按位置或键获取 Collection 对象的特定元素。

Item[Int32]

Source:

Collection.vb

按位置或键获取 Collection 对象的特定元素。

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

参数

Index

Int32

一个数值表达式，用于指定集合的元素位置。 Index 必须为介于 1 到集合的 Count 属性的值之间的数字。 或 (B) 指定集合中元素的位置或键字符串的 Object 表达式。

属性值

Object

对象的特定元素 Collection （按位置或键）。

示例

以下示例使用 Item 属性检索对集合中对象的引用。 它创建 birthdays 为 Collection 对象，然后使用 键 "Bill" 作为参数检索表示 Bill 生日的对象 Index 。

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

请注意，第一个调用显式指定 Item 属性，但第二个调用不指定。 这两个调用都有效， Item 因为 属性是 对象的默认属性 Collection 。

注解

如果 Index 的类型为 Object，则 Item 属性尝试将其视为 String、 Char、 Char 数组或整数值。 如果 Item 无法转换为 IndexString 或 Integer，则会引发 ArgumentException 异常。

属性 Item 是集合的默认属性。 因此，以下代码行是等效的。

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

Item[Object]

Source:

Collection.vb

按位置或键获取 Collection 对象的特定元素。

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

参数

Index

Object

一个数值表达式，用于指定集合的元素位置。 Index 必须为介于 1 到集合的 Count 属性的值之间的数字。 或 (B) 指定集合中元素的位置或键字符串的 Object 表达式。

属性值

Object

对象的特定元素 Collection （按位置或键）。

示例

以下示例使用 Item 属性检索对集合中对象的引用。 它创建 birthdays 为 Collection 对象，然后使用 键 "Bill" 作为参数检索表示 Bill 生日的对象 Index 。

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

请注意，第一个调用显式指定 Item 属性，但第二个调用不指定。 这两个调用都有效， Item 因为 属性是 对象的默认属性 Collection 。

注解

如果 Index 的类型为 Object，则 Item 属性尝试将其视为 String、 Char、 Char 数组或整数值。 如果 Item 无法转换为 IndexString 或 Integer，则会引发 ArgumentException 异常。

属性 Item 是集合的默认属性。 因此，以下代码行是等效的。

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

Item[String]

Source:

Collection.vb

按位置或键获取 Collection 对象的特定元素。

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

参数

Key

String

指定键字符串的唯一 String 表达式，可以使用此键字符串代替位置索引访问集合中的元素。 Key 必须对应于将元素添加到集合中时指定的 Key 参数。

属性值

Object

对象的特定元素 Collection （按位置或键）。

示例

以下示例使用 Item 属性检索对集合中对象的引用。 它创建 birthdays 为 Collection 对象，然后使用 键 "Bill" 作为参数检索表示 Bill 生日的对象 Index 。

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

请注意，第一个调用显式指定 Item 属性，但第二个调用不指定。 这两个调用都有效， Item 因为 属性是 对象的默认属性 Collection 。

注解

如果 Index 的类型为 Object，则 Item 属性尝试将其视为 String、 Char、 Char 数组或整数值。 如果 Item 无法转换为 IndexString 或 Integer，则会引发 ArgumentException 异常。

属性 Item 是集合的默认属性。 因此，以下代码行是等效的。

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