다음을 통해 공유


Hashtable.Item[Object] 속성

정의

지정된 키에 연결된 값을 가져오거나 설정합니다.

public:
 virtual property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };
public virtual object this[object key] { get; set; }
public virtual object? this[object key] { get; set; }
member this.Item(obj) : obj with get, set
Default Public Overridable Property Item(key As Object) As Object

매개 변수

key
Object

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

속성 값

지정한 키와 연결된 값입니다. 지정한 키가 없는 경우 해당 키를 가져오려고 시도하면 null이 반환되고 해당 키를 설정하려고 시도하면 지정한 키를 사용하여 새 요소가 만들어집니다.

구현

예외

key이(가) null인 경우

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

또는

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

설명

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

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

키는 일 수 없지만 null값은 일 수 있습니다. 지정된 키를 찾을 수 null 없기 때문에 반환되고 지정된 키의 null값이 이기 때문에 반환되는 값을 구분 null 하려면 메서드 또는 ContainsKey 메서드를 사용하여 Contains 키가 목록에 있는지 확인합니다.

이 속성의 값을 검색하는 작업은 작업입니다 O(1) . 속성 설정도 작업입니다 O(1) .

C# 언어에서는 this 속성을 구현하는 대신 Item[] 키워드를 사용하여 인덱서를 정의합니다. Visual Basic에서는 동일한 인덱싱 기능을 제공하는 Item[]을 기본 속성으로 구현합니다.

적용 대상

추가 정보