Hashtable.Item[Object] 속성

정의

지정된 키에 연결된 값을 가져오거나 설정합니다.Gets or sets the value associated with the specified key.

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; }
member this.Item(obj) : obj with get, set
Default Public Overridable Property Item(key As Object) As Object

매개 변수

key
Object

가져오거나 설정할 값이 있는 키입니다.The key whose value to get or set.

속성 값

지정한 키와 연결된 값입니다.The value associated with the specified key. 지정한 키가 없는 경우 해당 키를 가져오려고 시도하면 null이 반환되고 해당 키를 설정하려고 시도하면 지정한 키를 사용하여 새 요소가 만들어집니다.If the specified key is not found, attempting to get it returns null, and attempting to set it creates a new element using the specified key.

구현

예외

keynull인 경우key is null.

속성이 설정되어 있으며 Hashtable가 읽기 전용인 경우The property is set and the Hashtable is read-only.

또는-or- 속성이 설정되어 있고 key가 컬렉션에 없으며 Hashtable의 크기가 고정된 경우The property is set, key does not exist in the collection, and the Hashtable has a fixed size.

설명

이 속성은 myCollection[key] 구문을 사용하여 컬렉션의 특정 요소에 액세스하는 기능을 제공합니다.This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[key].

사용할 수도 있습니다는 Item[Object] 는 키의 값을 설정 하 여 새 요소를 추가 하는 속성에 없는 경우는 Hashtable예를 들어, myCollection["myNonexistentKey"] = myValue합니다.You can also use the Item[Object] property to add new elements by setting the value of a key that does not exist in the Hashtable; for example, myCollection["myNonexistentKey"] = myValue. 그러나 지정된 된 키가 이미 있는 경우는 Hashtable설정의 Item[Object] 속성 이전 값을 덮어씁니다.However, if the specified key already exists in the Hashtable, setting the Item[Object] property overwrites the old value. 반면,는 Add 메서드는 기존 요소를 수정 하지 않습니다.In contrast, the Add method does not modify existing elements.

키 일 수 없습니다 null에 있지만 값 수 있습니다.A key cannot be null, but a value can be. 구분 하기 위해 null 지정된 된 키를 찾을 수 없으므로 반환 되는 및 null 지정된 된 키의 값은 반환 되는 null를 사용 합니다 Contains 메서드 또는 ContainsKey 확인 하는 방법 키 목록에 있습니다.To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method or the ContainsKey method to determine if the key exists in the list.

이 속성의 값을 검색 하는 작업은 0 @no__t입니다. 속성을 설정 하는 작업은 @no__t 1 작업 이기도 합니다.Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.

이 C# 언어는 this 키워드를 사용 하 여 Item[Int32] 속성을 구현 하는 대신 인덱서를 정의 합니다.The C# language uses the this keyword to define the indexers instead of implementing the Item[Int32] property. Visual Basic에서는 동일한 인덱싱 기능을 제공하는 Item[Object]을 기본 속성으로 구현합니다.Visual Basic implements Item[Object] as a default property, which provides the same indexing functionality.

적용 대상

추가 정보