List<T>.Item[Int32] Properti

Definisi

Ruang nama:

System.Collections.Generic

Rakitan:

System.Collections.dll

Sumber:

List.cs

Mendapatkan atau mengatur elemen pada indeks yang ditentukan.

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

Parameter

index

Int32

Indeks berbasis nol dari elemen untuk mendapatkan atau mengatur.

Nilai Properti

T

Elemen pada indeks yang ditentukan.

Penerapan

Item[Int32]

Pengecualian

ArgumentOutOfRangeException

index kurang dari 0.

-atau-

index sama dengan atau lebih besar dari Count.

Contoh

Contoh di bagian ini menunjukkan Item[] properti (pengindeks di C#) dan berbagai properti dan metode lain dari List<T> kelas generik. Setelah daftar dibuat dan diisi menggunakan Add metode , elemen diambil dan ditampilkan menggunakan Item[] properti . (Untuk contoh yang menggunakan Item[] properti untuk mengatur nilai elemen daftar, lihat AsReadOnly.)

Catatan

Visual Basic, C#, dan C++ semuanya memiliki sintaks untuk mengakses Item[] properti tanpa menggunakan namanya. Sebagai gantinya, variabel yang List<T> berisi digunakan seolah-olah itu adalah array.

Bahasa C# menggunakan this kata kunci untuk menentukan pengindeks alih-alih mengimplementasikan Item[] properti . Visual Basic mengimplementasikan Item[] sebagai properti default, yang menyediakan fungsionalitas pengindeksan yang sama.

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))

Keterangan

List<T>null menerima sebagai nilai yang valid untuk jenis referensi dan memungkinkan elemen duplikat.

Properti ini menyediakan kemampuan untuk mengakses elemen tertentu dalam koleksi dengan menggunakan sintaks berikut: myCollection[index].

Mengambil nilai properti ini adalah operasi O(1) ; mengatur properti juga merupakan operasi O(1).

Lihat juga

• Count