List<T>.Item[Int32] Özellik

Tanım

Ad Alanı:

System.Collections.Generic

Bütünleştirilmiş Kod:

System.Collections.dll

Kaynak:

List.cs

Belirtilen dizindeki öğeyi alır veya ayarlar.

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

Parametreler

index

Int32

Alınacak veya ayarlanacak öğenin sıfır tabanlı dizini.

Özellik Değeri

T

Belirtilen dizindeki öğe.

Uygulamalar

Item[Int32]

Özel durumlar

ArgumentOutOfRangeException

index 0'dan küçüktür.

-veya-

index eşittir veya değerinden Countbüyüktür.

Örnekler

Bu bölümdeki örnekte özelliği (C# dilinde dizin oluşturucu) ve genel sınıfın List<T> diğer çeşitli özellikleri ve yöntemleri gösterilmektedirItem[]. Yöntemi kullanılarak Add liste oluşturulduktan ve doldurulduktan sonra, özelliği kullanılarak Item[] bir öğe alınır ve görüntülenir. (Bir liste öğesinin Item[] değerini ayarlamak için özelliğini kullanan bir örnek için bkz AsReadOnly. .)

Not

Visual Basic, C# ve C++ özelliklerinin tümü, adını kullanmadan özelliğe erişmek Item[] için söz dizimine sahiptir. Bunun yerine, öğesini içeren List<T> değişken bir diziymiş gibi kullanılır.

C# dili, özelliğini uygulamak yerine dizin oluşturucuları tanımlamak için anahtar sözcüğünü Item[] kullanırthis. Visual Basic, aynı dizin oluşturma işlevini sağlayan varsayılan bir özellik olarak uygular 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))

Açıklamalar

List<T> başvuru türleri için geçerli bir değer olarak kabul eder null ve yinelenen öğelere izin verir.

Bu özellik, aşağıdaki söz dizimini kullanarak koleksiyondaki belirli bir öğeye erişme olanağı sağlar: myCollection[index].

Bu özelliğin değerini almak bir O(1) işlemidir; özelliğini ayarlamak da bir O(1) işlemidir.

Ayrıca bkz.

• Count