Collection.Item[] 屬性

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.dll

透過位置或鍵位獲得物件的特定 Collection 元素。

多載

名稱 Description
Item[Int32]

透過位置或鍵位獲得物件的特定 Collection 元素。
Item[Object]

透過位置或鍵位獲得物件的特定 Collection 元素。
Item[String]

透過位置或鍵位獲得物件的特定 Collection 元素。

Item[Int32]

透過位置或鍵位獲得物件的特定 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" 作為 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]

透過位置或鍵位獲得物件的特定 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" 作為 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]

透過位置或鍵位獲得物件的特定 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" 作為 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)))

適用於