Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

List<T> — una lista genérica redimensionable

List<T> de System.Collections.Generic almacena elementos de un tipo especificado en una colección ordenada y modificable. El método Add añade un elemento al final, mientras que la propiedad Count indica el número actual de elementos, no la capacidad de la lista.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

List<T> items = new List<T>();
items.Add(value);
int count = items.Count;
T first = items[0];

List<T> de System.Collections.Generic es una lista modificable basada en un array, cuya capacidad aumenta cuando hace falta. El parámetro T especifica el tipo de los elementos, por ejemplo, List<string>. La lista admite duplicados y no ordena los elementos automáticamente. Los índices empiezan en cero; el intervalo válido es 0 <= index < Count.

List<T>.Add(T item) añade un elemento al final y devuelve void. Tras añadirlo correctamente, Count aumenta en uno. Si hay capacidad disponible, la operación tiene un coste O(1); si es necesario ampliar el array y copiar los elementos existentes, el coste es O(n), donde n es el valor anterior de Count.

List<T>.Count es una propiedad int de solo lectura, a la que se accede sin paréntesis: names.Count. Leerla tiene un coste O(1). Count representa el número de elementos almacenados, mientras que Capacity representa cuántos caben sin ampliar el array. new List<string>(4) crea una lista vacía con espacio para cuatro elementos; no crea cuatro elementos.

El ejemplo muestra una lista vacía, tres llamadas a Add, un duplicado y el acceso mediante índice. Estas API están disponibles en .NET 10 y no requieren características del lenguaje en versión preliminar. Si se comparte una lista entre varios subprocesos y se modifica, hace falta sincronización; los miembros de instancia no garantizan la seguridad entre subprocesos.

Ejemplos

using System;
using System.Collections.Generic;

internal static class Program
{
    private static void Main()
    {
        List<string> names = new List<string>(4);
        Console.WriteLine($"Count: {names.Count}");

        names.Add("Ada");
        names.Add("Linus");
        names.Add("Ada");

        Console.WriteLine($"Count: {names.Count}");
        Console.WriteLine($"First: {names[0]}");
        Console.WriteLine(string.Join(", ", names));
    }
}

Resultado

Count: 0
Count: 3
First: Ada
Ada, Linus, Ada

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes