List<T>.Item[Int32] Properti

Referensi

Definisi

Ruang nama:: System.Collections.Generic

Rakitan:: System.Collections.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Sumber:: List.cs

Sumber:: List.cs

Sumber:: List.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

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

Berlaku untuk

Lihat juga

Count