Hashtable.Item[Object] 속성

정의

네임스페이스:
System.Collections
어셈블리:
mscorlib.dll, System.Collections.NonGeneric.dll
어셈블리:
netstandard.dll, System.Runtime.dll
어셈블리:
System.Collections.NonGeneric.dll
어셈블리:
System.Runtime.Extensions.dll
어셈블리:
mscorlib.dll
어셈블리:
netstandard.dll
Source:
Hashtable.cs
Source:
Hashtable.cs
Source:
Hashtable.cs
Source:
Hashtable.cs
Source:
Hashtable.cs

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

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]사용하여 컬렉션의 특정 요소에 액세스하는 기능을 제공합니다.

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

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

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

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

적용 대상

추가 정보