List<T>.Item[Int32] Proprietà

Definizione

Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.Gets or sets the element at the specified index.

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

Parametri

index
Int32

Indice in base zero dell'elemento da ottenere o impostare.The zero-based index of the element to get or set.

Valore della proprietà

T

Elemento in corrispondenza dell'indice specificato.The element at the specified index.

Implementazioni

Eccezioni

index è minore di 0.index is less than 0.

-oppure--or- index è uguale a o maggiore di Count.index is equal to or greater than Count.

Esempio

Nell'esempio riportato in questa sezione viene illustrata la Item[] Proprietà (l'indicizzatore in C#) e diverse altre proprietà e metodi della List<T> classe generica.The example in this section demonstrates the Item[] property (the indexer in C#) and various other properties and methods of the List<T> generic class. Dopo che l'elenco è stato creato e popolato utilizzando il Add metodo, viene recuperato e visualizzato un elemento utilizzando la Item[] Proprietà.After the list has been created and populated using the Add method, an element is retrieved and displayed using the Item[] property. Per un esempio in cui viene utilizzata la Item[] proprietà per impostare il valore di un elemento elenco, vedere AsReadOnly .(For an example that uses the Item[] property to set the value of a list element, see AsReadOnly.)

Nota

Visual Basic, C# e C++ hanno tutti la sintassi per accedere alla Item[] proprietà senza usare il nome.Visual Basic, C#, and C++ all have syntax for accessing the Item[] property without using its name. Al contrario, la variabile che contiene List<T> viene utilizzata come se fosse una matrice.Instead, the variable containing the List<T> is used as if it were an array.

Il linguaggio C# usa la this parola chiave per definire gli indicizzatori anziché implementare la Item[] Proprietà.The C# language uses the this keyword to define the indexers instead of implementing the Item[] property. In Visual Basic la proprietà Item[] viene implementata come predefinita per fornire la stessa funzionalità di indicizzazione.Visual Basic implements Item[] as a default property, which provides the same indexing functionality.

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

Commenti

List<T> accetta null come valore valido per i tipi di riferimento e consente elementi duplicati.List<T> accepts null as a valid value for reference types and allows duplicate elements.

Questa proprietà consente di accedere a un elemento specifico nella raccolta utilizzando la sintassi seguente: myCollection[index].This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[index].

Il recupero del valore di questa proprietà è un'operazione O (1). l'impostazione della proprietà è anche un'operazione O (1).Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.

Si applica a

Vedi anche