다음을 통해 공유

Hashtable.Item 속성

  • 아티클

지정한 키와 관련된 값을 가져오거나 설정합니다.

네임스페이스: System.Collections
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
Public Overridable Default Property Item ( _
    key As Object _
) As Object
‘사용 방법
Dim instance As Hashtable
Dim key As Object
Dim value As Object

value = instance(key)

instance(key) = value

public virtual Object this [
    Object key
] { get; set; }

public:
virtual property Object^ default [Object^] {
    Object^ get (Object^ key);
    void set (Object^ key, Object^ value);
}

/** @property */
public Object get_Item (Object key)

/** @property */
public void set_Item (Object key, Object value)

JScript에서는 인덱싱된 속성을 사용할 수 있지만 새로 선언할 수는 없습니다.

매개 변수

  • key
    가져오거나 설정할 값이 있는 키입니다.

속성 값

지정한 키와 관련된 값입니다. 지정한 키가 없는 경우 해당 키를 가져오려고 시도하면 Null 참조(Visual Basic의 경우 Nothing)이 반환되고 해당 키를 설정하려고 시도하면 지정한 키를 사용하여 새 요소가 만들어집니다.

예외

예외 형식 조건

ArgumentNullException

key가 Null 참조(Visual Basic의 경우 Nothing)인 경우

NotSupportedException

속성이 설정되어 있으며 Hashtable가 읽기 전용인 경우

- 또는 -

속성이 설정되어 있고 key가 컬렉션에 없으며 Hashtable의 크기가 고정된 경우

설명

이 속성은 myCollection[key] 구문을 사용하여 컬렉션의 특정 요소에 액세스하는 기능을 제공합니다.

또한 Item 속성을 사용하면 Hashtable에 없는 키(예: myCollection["myNonexistentKey"] = myValue)의 값을 설정하여 새 요소를 추가할 수도 있습니다. 그러나 지정한 키가 이미 Hashtable에 있는 경우 Item 속성을 설정하면 이전 값을 덮어쓰게 됩니다. 이와는 반대로 Add 메서드에서는 기존 요소가 수정되지 않습니다.

키는 Null 참조(Visual Basic의 경우 Nothing)일 수 없으나 값은 null일 수 있습니다. 지정한 키가 없기 때문에 반환되는 Null 참조(Visual Basic의 경우 Nothing)과 지정한 키의 값이 Null 참조(Visual Basic의 경우 Nothing)이기 때문에 반환되는 Null 참조(Visual Basic의 경우 Nothing)을 구분하려면 Contains 메서드나 ContainsKey 메서드를 사용하여 해당 키가 목록에 있는지 여부를 확인합니다.

이 속성의 값을 검색하는 것은 O(1) 연산이고 속성을 설정하는 것도 O(1) 연산입니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

Hashtable 클래스
Hashtable 멤버
System.Collections 네임스페이스
Add