SortedList.Item[Object] 속성

정의

네임스페이스:

System.Collections

어셈블리:

System.Collections.NonGeneric.dll

Source:

SortedList.cs

SortedList 개체의 특정 키와 연관된 값을 가져오거나 설정합니다.

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

가져오거나 설정할 값과 관련된 키입니다.

속성 값

Object

key가 있으면 SortedList 개체의 key 매개 변수와 연관된 값이고, 그렇지 않으면 null입니다.

구현

Item[Object]

예외

ArgumentNullException

key이(가) null인 경우

NotSupportedException

속성이 설정되어 있고 SortedList 개체가 읽기 전용인 경우

또는

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

OutOfMemoryException

SortedList에 요소를 추가할 수 있는 메모리가 충분하지 않은 경우

InvalidOperationException

비교자에서 예외를 throw하는 경우

설명

다음 구문을 myCollection[key]지정하여 속성을 사용하여 Item[] 컬렉션의 특정 요소에 액세스할 수 있습니다.

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

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

의 SortedList 요소는 가 생성될 때 SortedList 지정된 특정 IComparer 구현에 따라 또는 키 자체에서 제공하는 구현에 IComparable 따라 키별로 정렬됩니다.

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

이 속성의 값을 검색하는 작업은 이 O(log n) 고, 여기서 n 는 입니다 Count. 속성 설정은 O(log n) 키가 이미 에 있는 SortedList경우 작업입니다. 키가 목록에 없으면 속성 설정은 정렬되지 않은 데이터에 대한 작업이거나 O(log n) 목록 끝에 새 요소가 추가된 경우 입니다O(n). 삽입으로 인해 크기가 조정되면 작업은 입니다 O(n).

추가 정보

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• 컬렉션에서 문화권을 구분하지 않는 문자열 작업 수행