다음을 통해 공유


List<T>.Item[Int32] 속성

정의

지정한 인덱스에 있는 요소를 가져오거나 설정합니다.

public:
 property T default[int] { T get(int index); void set(int index, T value); };
public T this[int index] { get; set; }
member this.Item(int) : 'T with get, set
Default Public Property Item(index As Integer) As T

매개 변수

index
Int32

가져오거나 설정할 요소의 인덱스(0부터 시작)입니다.

속성 값

T

지정한 인덱스의 요소입니다.

구현

예외

index 가 0보다 작습니다.

또는

indexCount보다 크거나 같은 경우

예제

이 섹션의 Item[] 예제에서는 속성(C#의 인덱서) 및 제네릭 클래스의 다양한 다른 속성 및 메서드를 List<T> 보여 줍니다. 메서드를 사용하여 Add 목록이 만들어지고 채워지면 속성을 사용하여 Item[] 요소가 검색되고 표시됩니다. 속성을 사용하여 Item[] 목록 요소의 값을 설정하는 예제는 를 참조하세요 AsReadOnly.

참고

Visual Basic, C#및 C++에는 모두 이름을 사용하지 않고 속성에 Item[] 액세스하기 위한 구문이 있습니다. 대신 를 포함하는 List<T> 변수는 배열인 것처럼 사용됩니다.

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

List<string> dinosaurs = new List<string>();

Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);

dinosaurs.Add("Tyrannosaurus");
dinosaurs.Add("Amargasaurus");
dinosaurs.Add("Mamenchisaurus");
dinosaurs.Add("Deinonychus");
dinosaurs.Add("Compsognathus");
Dim dinosaurs As New List(Of String)

Console.WriteLine(vbLf & "Capacity: {0}", dinosaurs.Capacity)

dinosaurs.Add("Tyrannosaurus")
dinosaurs.Add("Amargasaurus")
dinosaurs.Add("Mamenchisaurus")
dinosaurs.Add("Deinonychus")
dinosaurs.Add("Compsognathus")
// Shows accessing the list using the Item property.
Console.WriteLine("\ndinosaurs[3]: {0}", dinosaurs[3]);
' Shows how to access the list using the Item property.
Console.WriteLine(vbLf & "dinosaurs(3): {0}", dinosaurs(3))

설명

List<T>null 참조 형식에 유효한 값으로 허용되고 중복 요소를 허용합니다.

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

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

적용 대상

추가 정보