다음을 통해 공유


Item 속성(Collection 개체)

업데이트: 2007년 11월

위치 또는 키로 Collection 개체의 특정 멤버를 반환합니다. 이 속성은 읽기 전용입니다.

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

매개 변수

  • Key
    위치 인덱스 대신 컬렉션 요소에 액세스하는 데 사용할 수 있는 키 문자열을 지정하는 고유 String 식입니다. Key는 컬렉션에 요소를 추가할 때 지정한 Key 인수와 일치해야 합니다.

  • Index
    (A) 컬렉션 요소의 위치를 지정하는 숫자 식입니다. Index는 1에서 컬렉션의 Count 속성(Collection 개체) 값 사이의 숫자여야 합니다. 또는 (B) 컬렉션 요소의 위치 또는 키 문자열을 지정하는 Object 식입니다.

예외

예외 형식

오류 번호

조건

ArgumentException

5

  • Key가 잘못되었거나 컬렉션의 기존 요소와 일치하지 않습니다.

  • Index가 문자 데이터 또는 숫자 데이터로 해석될 수 없습니다.

IndexOutOfRangeException

9

  • Key가 Nothing입니다.

  • Index가 컬렉션의 기존 요소와 일치하지 않습니다.

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

Index가 Object 형식이면 Item 속성은 이를 String, Char, Char 배열 또는 정수 값으로 처리하려고 시도합니다. Item이 Index를 String 또는 Integer로 변환할 수 없는 경우에는 ArgumentException 예외를 throw합니다.

Item 속성은 컬렉션의 기본 속성입니다. 따라서 이에 해당하는 코드는 다음과 같습니다.

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

예제

다음 예제에서는 Item 속성을 사용하여 컬렉션의 개체에 대한 참조를 검색합니다. 즉, birthdays를 Collection 개체로 만들고 "Bill" 키를 Index 인수로 사용하여 Bill의 생일을 나타내는 개체를 검색합니다.

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 개체의 기본값이기 때문에 두 호출에서 모두 사용됩니다.

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**Collection

**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

참고 항목

참조

Collection 개체(Visual Basic)

Add 메서드(Collection 개체)

Count 속성(Collection 개체)

Remove 메서드(Collection 개체)