Hashtable.Item[Object] 속성

정의

네임스페이스:

System.Collections

어셈블리:

mscorlib.dll, System.Collections.NonGeneric.dll

어셈블리:

System.Runtime.dll

어셈블리:

System.Collections.NonGeneric.dll

어셈블리:

System.Runtime.Extensions.dll

어셈블리:

mscorlib.dll

어셈블리:

netstandard.dll

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

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

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

속성 값

Object

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

구현

Item[Object]

예외

ArgumentNullException

key이(가) null인 경우

NotSupportedException

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

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

설명

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

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

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

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

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

추가 정보

• Add(Object, Object)