다음을 통해 공유


SortedList.Item[Object] 속성

정의

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; }
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

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

속성 값

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

구현

예외

key이(가) null인 경우

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

또는

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

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

비교자에서 예외를 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).

적용 대상

추가 정보