Collection.Item[] Свойство

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Получает определенный элемент объекта Collection по номеру позиции или ключу.

Перегрузки

Item[Int32]	Получает определенный элемент объекта Collection по номеру позиции или ключу.
Item[Object]	Получает определенный элемент объекта Collection по номеру позиции или ключу.
Item[String]	Получает определенный элемент объекта Collection по номеру позиции или ключу.

Item[Int32]

Исходный код:

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 коллекции. Или (Б) выражение типа 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 не удается преобразовать Index в String или Integer, создается ArgumentException исключение.

Свойство Item является свойством по умолчанию для коллекции. Таким образом, следующие строки кода эквивалентны.

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

Item[Object]

Исходный код:

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 коллекции. Или (Б) выражение типа 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 не удается преобразовать Index в String или Integer, создается ArgumentException исключение.

Свойство Item является свойством по умолчанию для коллекции. Таким образом, следующие строки кода эквивалентны.

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

Item[String]

Исходный код:

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" в качестве аргумента 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 не удается преобразовать Index в String или Integer, создается ArgumentException исключение.

Свойство Item является свойством по умолчанию для коллекции. Таким образом, следующие строки кода эквивалентны.

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