Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase List<T>

 

Publicado: octubre de 2016

Representa una lista de objetos fuertemente tipados a la que se puede obtener acceso por índice. Proporciona métodos para buscar, ordenar y manipular listas.

Para examinar el código fuente de .NET Framework para este tipo, vea la Reference Source.

Espacio de nombres:   System.Collections.Generic
Ensamblado:  mscorlib (en mscorlib.dll)


[SerializableAttribute]
public class List<T> : IList<T>, ICollection<T>, IEnumerable<T>, 
	IEnumerable, IList, ICollection, IReadOnlyList<T>, IReadOnlyCollection<T>

Parámetros de tipo

T

Tipo de elementos en la lista.

NombreDescripción
System_CAPS_pubmethodList<T>()

Inicializa una nueva instancia de la clase List<T> que está vacía y tiene la capacidad inicial predeterminada.

System_CAPS_pubmethodList<T>(IEnumerable<T>)

Inicializa una nueva instancia de la clase List<T> que contiene elementos copiados de la colección especificada y tiene una capacidad suficiente para aceptar el número de elementos copiados.

System_CAPS_pubmethodList<T>(Int32)

Inicializa una nueva instancia de la clase List<T> que está vacía y tiene la capacidad inicial especificada.

NombreDescripción
System_CAPS_pubpropertyCapacity

Obtiene o establece el número total de elementos que puede contener la estructura de datos interna sin cambiar el tamaño.

System_CAPS_pubpropertyCount

Obtiene el número de elementos incluidos en List<T>.

System_CAPS_pubpropertyItem[Int32]

Obtiene o establece el elemento en el índice especificado.

NombreDescripción
System_CAPS_pubmethodAdd(T)

Agrega un objeto al final de List<T>.

System_CAPS_pubmethodAddRange(IEnumerable<T>)

Agrega los elementos de la colección especificada al final de List<T>.

System_CAPS_pubmethodAsReadOnly()

Devuelve un contenedor de ReadOnlyCollection<T> de solo lectura para la colección actual.

System_CAPS_pubmethodBinarySearch(T)

Busca la List<T> completa ordenada para un elemento usando el comparador predeterminado y devuelve el índice de base cero del elemento.

System_CAPS_pubmethodBinarySearch(T, IComparer<T>)

Busca la List<T> completa ordenada para un elemento usando el comparador especificado y devuelve el índice de base cero del elemento.

System_CAPS_pubmethodBinarySearch(Int32, Int32, T, IComparer<T>)

Busca un elemento en un intervalo de elementos del objeto List<T> ordenado usando el comparador especificado y devuelve el índice de base cero del elemento.

System_CAPS_pubmethodClear()

Quita todos los elementos de List<T>.

System_CAPS_pubmethodContains(T)

Determina si un elemento se encuentra en List<T>.

System_CAPS_pubmethodConvertAll<TOutput>(Converter<T, TOutput>)

Convierte en otro tipo los elementos incluidos en la List<T> actual y devuelve una lista que contiene los elementos convertidos.

System_CAPS_pubmethodCopyTo(T[])

Copia toda la List<T> en una matriz unidimensional compatible, empezando en el principio de la matriz de destino.

System_CAPS_pubmethodCopyTo(T[], Int32)

Copia la totalidad de List<T> en una matriz unidimensional compatible, empezando por el índice especificado de la matriz de destino.

System_CAPS_pubmethodCopyTo(Int32, T[], Int32, Int32)

Copia un intervalo de elementos de List<T> en una matriz unidimensional compatible, empezando en el índice especificado de la matriz de destino.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodExists(Predicate<T>)

Determina si List<T> contiene elementos que cumplen las condiciones definidas por el predicado especificado.

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodFind(Predicate<T>)

Busca un elemento que coincida con las condiciones definidas por el predicado especificado y devuelve la primera aparición en toda la matriz List<T>.

System_CAPS_pubmethodFindAll(Predicate<T>)

Recupera todos los elementos que coinciden con las condiciones definidas por el predicado especificado.

System_CAPS_pubmethodFindIndex(Int32, Int32, Predicate<T>)

Busca un elemento que coincida con las condiciones definidas por el predicado especificado y devuelve el índice de base cero de la primera aparición en el intervalo de elementos de la matriz List<T> que comienza en el índice especificado y contiene el número especificado de elementos.

System_CAPS_pubmethodFindIndex(Int32, Predicate<T>)

Busca un elemento que coincida con las condiciones definidas por el predicado especificado y devuelve el índice de base cero de la primera aparición en el intervalo de elementos de la matriz List<T> que va desde el índice especificado hasta el último elemento.

System_CAPS_pubmethodFindIndex(Predicate<T>)

Busca un elemento que coincida con las condiciones definidas por el predicado especificado y devuelve el índice de base cero de la primera aparición en toda la matriz List<T>.

System_CAPS_pubmethodFindLast(Predicate<T>)

Busca un elemento que coincida con las condiciones definidas por el predicado especificado y devuelve la última aparición en toda la matriz List<T>.

System_CAPS_pubmethodFindLastIndex(Int32, Int32, Predicate<T>)

Busca un elemento que coincida con las condiciones definidas por el predicado especificado y devuelve el índice de base cero de la última aparición en el intervalo de elementos de la matriz List<T> que contiene el número especificado de elementos y termina en el índice especificado.

System_CAPS_pubmethodFindLastIndex(Int32, Predicate<T>)

Busca un elemento que coincida con las condiciones definidas por el predicado especificado y devuelve el índice de base cero de la última aparición en el intervalo de elementos de la matriz List<T> que va desde el primer elemento hasta el índice especificado.

System_CAPS_pubmethodFindLastIndex(Predicate<T>)

Busca un elemento que coincida con las condiciones definidas por el predicado especificado y devuelve el índice de base cero de la última aparición en toda la matriz List<T>.

System_CAPS_pubmethodForEach(Action<T>)

Realiza la acción especificada en cada elemento de List<T>.

System_CAPS_pubmethodGetEnumerator()

Devuelve un enumerador que recorre en iteración la colección List<T>.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetRange(Int32, Int32)

Crea una copia superficial de un intervalo de elementos en la List<T> de origen.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIndexOf(T)

Busca el objeto especificado y devuelve el índice de base cero de la primera aparición en todo el objeto List<T>.

System_CAPS_pubmethodIndexOf(T, Int32)

Busca el objeto especificado y devuelve el índice de base cero de la primera aparición dentro del intervalo de elementos de List<T> que abarca desde el índice especificado hasta el último elemento.

System_CAPS_pubmethodIndexOf(T, Int32, Int32)

Busca el objeto especificado y devuelve el índice de base cero de la primera aparición dentro del intervalo de elementos de List<T> que comienza en el índice especificado y contiene el número especificado de elementos.

System_CAPS_pubmethodInsert(Int32, T)

Inserta un elemento en List<T>, en el índice especificado.

System_CAPS_pubmethodInsertRange(Int32, IEnumerable<T>)

Inserta los elementos de una colección en List<T> en el índice especificado.

System_CAPS_pubmethodLastIndexOf(T)

Busca el objeto especificado y devuelve el índice de base cero de la última aparición en toda la List<T>.

System_CAPS_pubmethodLastIndexOf(T, Int32)

Busca el objeto especificado y devuelve el índice de base cero de la última aparición dentro del intervalo de elementos de List<T> que abarca desde el primer elemento hasta el último índice especificado.

System_CAPS_pubmethodLastIndexOf(T, Int32, Int32)

Busca el objeto especificado y devuelve el índice de base cero de la última aparición dentro del intervalo de elementos de List<T> que contiene el número de elementos especificado y termina en el índice determinado.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodRemove(T)

Quita la primera aparición de un objeto específico de la interfaz List<T>.

System_CAPS_pubmethodRemoveAll(Predicate<T>)

Quita todos los elementos que cumplen las condiciones definidas por el predicado especificado.

System_CAPS_pubmethodRemoveAt(Int32)

Quita el elemento situado en el índice especificado de List<T>.

System_CAPS_pubmethodRemoveRange(Int32, Int32)

Quita todos los elementos de List<T>.

System_CAPS_pubmethodReverse()

Invierte el orden de los elementos en la List<T> completa.

System_CAPS_pubmethodReverse(Int32, Int32)

Invierte el orden de los elementos en el intervalo especificado.

System_CAPS_pubmethodSort()

Ordena los elementos de toda la List<T> utilizando el comparador predeterminado.

System_CAPS_pubmethodSort(Comparison<T>)

Ordena los elementos de toda la List<T> utilizando el System.Comparison<T> especificado.

System_CAPS_pubmethodSort(IComparer<T>)

Ordena los elementos en la List<T> completa usando el comparador especificado.

System_CAPS_pubmethodSort(Int32, Int32, IComparer<T>)

Ordena los elementos en un intervalo de elementos de la matriz List<T> usando el comparador especificado.

System_CAPS_pubmethodToArray()

Copia los elementos de List<T> en una nueva matriz.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodTrimExcess()

Establece la capacidad en el número real de elementos que hay en List<T>, si dicho número es inferior a un valor umbral.

System_CAPS_pubmethodTrueForAll(Predicate<T>)

Determina si cada elemento de List<T> cumple las condiciones que define el predicado especificado.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIEnumerable<T>.GetEnumerator()

Devuelve un enumerador que recorre en iteración una colección.

System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Copia los elementos de ICollection en Array, empezando por un índice determinado de Array.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIEnumerable.GetEnumerator()

Devuelve un enumerador que recorre en iteración una colección.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Agrega un elemento a IList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Determina si IList contiene un valor específico.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.IndexOf(Object)

Determina el índice de un elemento específico de IList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Insert(Int32, Object)

Inserta un elemento en la interfaz IList, en el índice especificado.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Remove(Object)

Quita la primera aparición de un objeto específico de la interfaz IList.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection<T>.IsReadOnly

Obtiene un valor que indica si ICollection<T> es de solo lectura.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Obtiene un valor que indica si el acceso a la interfaz ICollection está sincronizado (es seguro para subprocesos).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a ICollection.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Obtiene un valor que indica si la interfaz IList tiene un tamaño fijo.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsReadOnly

Obtiene un valor que indica si IList es de solo lectura.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.

NombreDescripción
System_CAPS_pubmethodAggregate<T>(Func<T, T, T>)

Sobrecargado. Aplica una función de acumulador a una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodAggregate<T, TAccumulate>(TAccumulate, Func<TAccumulate, T, TAccumulate>)

Sobrecargado. Aplica una función de acumulador a una secuencia. El valor de inicialización especificado se utiliza como valor de inicio del acumulador.(Definido por Enumerable).

System_CAPS_pubmethodAggregate<T, TAccumulate, TResult>(TAccumulate, Func<TAccumulate, T, TAccumulate>, Func<TAccumulate, TResult>)

Sobrecargado. Aplica una función de acumulador a una secuencia. El valor de inicialización especificado se utiliza como valor inicial del acumulador y la función especificada se utiliza para seleccionar el valor resultante.(Definido por Enumerable).

System_CAPS_pubmethodAll<T>(Func<T, Boolean>)

Determina si todos los elementos de una secuencia satisfacen una condición.(Definido por Enumerable).

System_CAPS_pubmethodAny<T>()

Sobrecargado. Determina si una secuencia contiene elementos.(Definido por Enumerable).

System_CAPS_pubmethodAny<T>(Func<T, Boolean>)

Sobrecargado. Determina si un elemento de una secuencia satisface una condición.(Definido por Enumerable).

System_CAPS_pubmethodAsEnumerable<T>()

Devuelve la entrada de tipo IEnumerable<T>.(Definido por Enumerable).

System_CAPS_pubmethodAsParallel()

Sobrecargado. Habilita la paralelización de una consulta.(Definido por ParallelEnumerable).

System_CAPS_pubmethodAsParallel<T>()

Sobrecargado. Habilita la paralelización de una consulta.(Definido por ParallelEnumerable).

System_CAPS_pubmethodAsQueryable()

Sobrecargado. Convierte un IEnumerable para un IQueryable.(Definido por Queryable).

System_CAPS_pubmethodAsQueryable<T>()

Sobrecargado. Convierte un tipo genérico IEnumerable<T> a un tipo genérico IQueryable<T>.(Definido por Queryable).

System_CAPS_pubmethodAverage<T>(Func<T, Decimal>)

Sobrecargado. Calcula el promedio de una secuencia de Decimal valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Double>)

Sobrecargado. Calcula el promedio de una secuencia de Double valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Int32>)

Sobrecargado. Calcula el promedio de una secuencia de Int32 valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Int64>)

Sobrecargado. Calcula el promedio de una secuencia de Int64 valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Nullable<Decimal>>)

Sobrecargado. Calcula el promedio de una secuencia de nullable Decimal valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Nullable<Double>>)

Sobrecargado. Calcula el promedio de una secuencia de nullable Double valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Nullable<Int32>>)

Sobrecargado. Calcula el promedio de una secuencia de nullable Int32 valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Nullable<Int64>>)

Sobrecargado. Calcula el promedio de una secuencia de nullable Int64 valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Nullable<Single>>)

Sobrecargado. Calcula el promedio de una secuencia de nullable Single valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodAverage<T>(Func<T, Single>)

Sobrecargado. Calcula el promedio de una secuencia de Single valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodCast<TResult>()

Convierte los elementos de un IEnumerable al tipo especificado.(Definido por Enumerable).

System_CAPS_pubmethodConcat<T>(IEnumerable<T>)

Concatena dos secuencias.(Definido por Enumerable).

System_CAPS_pubmethodContains<T>(T)

Sobrecargado. Determina si una secuencia contiene un elemento especificado mediante el comparador de igualdad predeterminado.(Definido por Enumerable).

System_CAPS_pubmethodContains<T>(T, IEqualityComparer<T>)

Sobrecargado. Determina si una secuencia contiene un elemento especificado mediante el uso de un objeto IEqualityComparer<T>.(Definido por Enumerable).

System_CAPS_pubmethodCount<T>()

Sobrecargado. Devuelve el número de elementos de una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodCount<T>(Func<T, Boolean>)

Sobrecargado. Devuelve un número que representa cuántos elementos de la secuencia especificada satisfacen una condición.(Definido por Enumerable).

System_CAPS_pubmethodDefaultIfEmpty<T>()

Sobrecargado. Devuelve los elementos de la secuencia especificada o el valor predeterminado del parámetro de tipo en una colección singleton si la secuencia está vacía.(Definido por Enumerable).

System_CAPS_pubmethodDefaultIfEmpty<T>(T)

Sobrecargado. Devuelve los elementos de la secuencia especificada o el valor especificado en una colección singleton si la secuencia está vacía.(Definido por Enumerable).

System_CAPS_pubmethodDistinct<T>()

Sobrecargado. Devuelve diversos elementos de una secuencia utilizando el comparador de igualdad predeterminado para comparar valores.(Definido por Enumerable).

System_CAPS_pubmethodDistinct<T>(IEqualityComparer<T>)

Sobrecargado. Devuelve diversos elementos de una secuencia utilizando un IEqualityComparer<T> para comparar valores.(Definido por Enumerable).

System_CAPS_pubmethodElementAt<T>(Int32)

Devuelve el elemento en un índice especificado en una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodElementAtOrDefault<T>(Int32)

Devuelve el elemento situado en un índice especificado de una secuencia o un valor predeterminado si el índice está fuera del intervalo.(Definido por Enumerable).

System_CAPS_pubmethodExcept<T>(IEnumerable<T>)

Sobrecargado. Proporciona la diferencia de conjunto de dos secuencias utilizando el comparador de igualdad predeterminado para comparar valores.(Definido por Enumerable).

System_CAPS_pubmethodExcept<T>(IEnumerable<T>, IEqualityComparer<T>)

Sobrecargado. Proporciona la diferencia de conjuntos de dos secuencias mediante especificado IEqualityComparer<T> para comparar valores.(Definido por Enumerable).

System_CAPS_pubmethodFirst<T>()

Sobrecargado. Devuelve el primer elemento de una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodFirst<T>(Func<T, Boolean>)

Sobrecargado. Devuelve el primer elemento de una secuencia que satisface una condición especificada.(Definido por Enumerable).

System_CAPS_pubmethodFirstOrDefault<T>()

Sobrecargado. Devuelve el primer elemento de una secuencia o un valor predeterminado si la secuencia no contiene elementos.(Definido por Enumerable).

System_CAPS_pubmethodFirstOrDefault<T>(Func<T, Boolean>)

Sobrecargado. Devuelve el primer elemento de la secuencia que satisface una condición o un valor predeterminado si no se encuentra dicho elemento.(Definido por Enumerable).

System_CAPS_pubmethodGroupBy<T, TKey>(Func<T, TKey>)

Sobrecargado. Agrupa los elementos de una secuencia según una función del selector de claves especificada.(Definido por Enumerable).

System_CAPS_pubmethodGroupBy<T, TKey>(Func<T, TKey>, IEqualityComparer<TKey>)

Sobrecargado. Agrupa los elementos de una secuencia según una función del selector de claves especificada y compara las claves utilizando un comparador especificado.(Definido por Enumerable).

System_CAPS_pubmethodGroupBy<T, TKey, TElement>(Func<T, TKey>, Func<T, TElement>)

Sobrecargado. Agrupa los elementos de una secuencia según una función del selector de claves especificada y proyecta los elementos de cada grupo utilizando una función especificada.(Definido por Enumerable).

System_CAPS_pubmethodGroupBy<T, TKey, TElement>(Func<T, TKey>, Func<T, TElement>, IEqualityComparer<TKey>)

Sobrecargado. Agrupa los elementos de una secuencia según una función del selector de claves. Las claves se comparan utilizando un comparador y los elementos de cada grupo se proyectan utilizando una función especificada.(Definido por Enumerable).

System_CAPS_pubmethodGroupBy<T, TKey, TResult>(Func<T, TKey>, Func<TKey, IEnumerable<T>, TResult>)

Sobrecargado. Agrupa los elementos de una secuencia según una función del selector de claves especificada y crea un valor de resultado a partir de cada grupo y su clave.(Definido por Enumerable).

System_CAPS_pubmethodGroupBy<T, TKey, TResult>(Func<T, TKey>, Func<TKey, IEnumerable<T>, TResult>, IEqualityComparer<TKey>)

Sobrecargado. Agrupa los elementos de una secuencia según una función del selector de claves especificada y crea un valor de resultado a partir de cada grupo y su clave. Las claves se comparan utilizando un comparador especificado.(Definido por Enumerable).

System_CAPS_pubmethodGroupBy<T, TKey, TElement, TResult>(Func<T, TKey>, Func<T, TElement>, Func<TKey, IEnumerable<TElement>, TResult>)

Sobrecargado. Agrupa los elementos de una secuencia según una función del selector de claves especificada y crea un valor de resultado a partir de cada grupo y su clave. Los elementos de cada grupo se proyectan utilizando una función determinada.(Definido por Enumerable).

System_CAPS_pubmethodGroupBy<T, TKey, TElement, TResult>(Func<T, TKey>, Func<T, TElement>, Func<TKey, IEnumerable<TElement>, TResult>, IEqualityComparer<TKey>)

Sobrecargado. Agrupa los elementos de una secuencia según una función del selector de claves especificada y crea un valor de resultado a partir de cada grupo y su clave. Los valores de las claves se comparan utilizando un comparador especificado y los elementos de cada grupo se proyectan utilizando una función especificada.(Definido por Enumerable).

System_CAPS_pubmethodGroupJoin<T, TInner, TKey, TResult>(IEnumerable<TInner>, Func<T, TKey>, Func<TInner, TKey>, Func<T, IEnumerable<TInner>, TResult>)

Sobrecargado. Correlaciona los elementos de dos secuencias basándose en la igualdad de claves y agrupa los resultados. El comparador de igualdad predeterminado se usa para comparar claves.(Definido por Enumerable).

System_CAPS_pubmethodGroupJoin<T, TInner, TKey, TResult>(IEnumerable<TInner>, Func<T, TKey>, Func<TInner, TKey>, Func<T, IEnumerable<TInner>, TResult>, IEqualityComparer<TKey>)

Sobrecargado. Correlaciona los elementos de dos secuencias basándose en la igualdad de claves y agrupa los resultados. Se usa un IEqualityComparer<T> especificado para comparar claves.(Definido por Enumerable).

System_CAPS_pubmethodIntersect<T>(IEnumerable<T>)

Sobrecargado. Proporciona la intersección de conjunto de dos secuencias utilizando el comparador de igualdad predeterminado para comparar valores.(Definido por Enumerable).

System_CAPS_pubmethodIntersect<T>(IEnumerable<T>, IEqualityComparer<T>)

Sobrecargado. Proporciona la intersección de conjunto de dos secuencias utilizando los IEqualityComparer<T> para comparar valores.(Definido por Enumerable).

System_CAPS_pubmethodJoin<T, TInner, TKey, TResult>(IEnumerable<TInner>, Func<T, TKey>, Func<TInner, TKey>, Func<T, TInner, TResult>)

Sobrecargado. Correlaciona los elementos de dos secuencias basadas en claves coincidentes. El comparador de igualdad predeterminado se usa para comparar claves.(Definido por Enumerable).

System_CAPS_pubmethodJoin<T, TInner, TKey, TResult>(IEnumerable<TInner>, Func<T, TKey>, Func<TInner, TKey>, Func<T, TInner, TResult>, IEqualityComparer<TKey>)

Sobrecargado. Correlaciona los elementos de dos secuencias basadas en claves coincidentes. Se usa un IEqualityComparer<T> especificado para comparar claves.(Definido por Enumerable).

System_CAPS_pubmethodLast<T>()

Sobrecargado. Devuelve el último elemento de una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodLast<T>(Func<T, Boolean>)

Sobrecargado. Devuelve el último elemento de una secuencia que satisface una condición especificada.(Definido por Enumerable).

System_CAPS_pubmethodLastOrDefault<T>()

Sobrecargado. Devuelve el último elemento de una secuencia o un valor predeterminado si la secuencia no contiene elementos.(Definido por Enumerable).

System_CAPS_pubmethodLastOrDefault<T>(Func<T, Boolean>)

Sobrecargado. Devuelve el último elemento de una secuencia que satisface una condición o un valor predeterminado si no se encuentra dicho elemento.(Definido por Enumerable).

System_CAPS_pubmethodLongCount<T>()

Sobrecargado. Devuelve un Int64 que representa el número total de elementos de una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodLongCount<T>(Func<T, Boolean>)

Sobrecargado. Devuelve un Int64 que representa el número de elementos de una secuencia satisface una condición.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>()

Sobrecargado. Devuelve el valor máximo de una secuencia genérica.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Decimal>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo Decimal valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Double>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo Double valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Int32>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo Int32 valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Int64>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo Int64 valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Nullable<Decimal>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo que acepta valores NULL Decimal valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Nullable<Double>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo que acepta valores NULL Double valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Nullable<Int32>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo que acepta valores NULL Int32 valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Nullable<Int64>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo que acepta valores NULL Int64 valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Nullable<Single>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo que acepta valores NULL Single valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T>(Func<T, Single>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el valor máximo Single valor.(Definido por Enumerable).

System_CAPS_pubmethodMax<T, TResult>(Func<T, TResult>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia genérica y devuelve el valor máximo resultante.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>()

Sobrecargado. Devuelve el valor mínimo de una secuencia genérica.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Decimal>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo Decimal valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Double>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo Double valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Int32>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo Int32 valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Int64>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo Int64 valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Nullable<Decimal>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo que acepta valores NULL Decimal valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Nullable<Double>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo que acepta valores NULL Double valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Nullable<Int32>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo que acepta valores NULL Int32 valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Nullable<Int64>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo que acepta valores NULL Int64 valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Nullable<Single>>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo que acepta valores NULL Single valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T>(Func<T, Single>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia y devuelve el mínimo Single valor.(Definido por Enumerable).

System_CAPS_pubmethodMin<T, TResult>(Func<T, TResult>)

Sobrecargado. Invoca una función de transformación en cada elemento de una secuencia genérica y devuelve el valor mínimo resultante.(Definido por Enumerable).

System_CAPS_pubmethodOfType<TResult>()

Filtra los elementos de un IEnumerable basado en un tipo especificado.(Definido por Enumerable).

System_CAPS_pubmethodOrderBy<T, TKey>(Func<T, TKey>)

Sobrecargado. Ordena los elementos de una secuencia en orden ascendente según una clave.(Definido por Enumerable).

System_CAPS_pubmethodOrderBy<T, TKey>(Func<T, TKey>, IComparer<TKey>)

Sobrecargado. Ordena los elementos de una secuencia en orden ascendente mediante un comparador especificado.(Definido por Enumerable).

System_CAPS_pubmethodOrderByDescending<T, TKey>(Func<T, TKey>)

Sobrecargado. Ordena los elementos de una secuencia en orden descendente según una clave.(Definido por Enumerable).

System_CAPS_pubmethodOrderByDescending<T, TKey>(Func<T, TKey>, IComparer<TKey>)

Sobrecargado. Ordena de manera descendente los elementos de una secuencia utilizando un comparador especificado.(Definido por Enumerable).

System_CAPS_pubmethodReverse<T>()

Invierte el orden de los elementos de una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodSelect<T, TResult>(Func<T, TResult>)

Sobrecargado. Proyecta cada elemento de una secuencia a un nuevo formulario.(Definido por Enumerable).

System_CAPS_pubmethodSelect<T, TResult>(Func<T, Int32, TResult>)

Sobrecargado. Proyecta cada elemento de una secuencia en un nuevo formulario mediante la incorporación del índice del elemento.(Definido por Enumerable).

System_CAPS_pubmethodSelectMany<T, TResult>(Func<T, IEnumerable<TResult>>)

Sobrecargado. Proyecta cada elemento de una secuencia en un IEnumerable<T> y reduce las secuencias resultantes en una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodSelectMany<T, TResult>(Func<T, Int32, IEnumerable<TResult>>)

Sobrecargado. Proyecta cada elemento de una secuencia en un IEnumerable<T>, y reduce las secuencias resultantes en una secuencia. El índice de cada elemento de origen se utiliza en el formulario proyectado de ese elemento.(Definido por Enumerable).

System_CAPS_pubmethodSelectMany<T, TCollection, TResult>(Func<T, IEnumerable<TCollection>>, Func<T, TCollection, TResult>)

Sobrecargado. Proyecta cada elemento de una secuencia en IEnumerable<T>, reduce las secuencias resultantes en una única secuencia e invoca una función del selector de resultados en cada elemento.(Definido por Enumerable).

System_CAPS_pubmethodSelectMany<T, TCollection, TResult>(Func<T, Int32, IEnumerable<TCollection>>, Func<T, TCollection, TResult>)

Sobrecargado. Proyecta cada elemento de una secuencia en IEnumerable<T>, reduce las secuencias resultantes en una única secuencia e invoca una función del selector de resultados en cada elemento. El índice de cada elemento de origen se utiliza en el formulario proyectado intermedio de ese elemento.(Definido por Enumerable).

System_CAPS_pubmethodSequenceEqual<T>(IEnumerable<T>)

Sobrecargado. Determina si dos secuencias son iguales al comparar los elementos mediante el comparador de igualdad predeterminado para su tipo.(Definido por Enumerable).

System_CAPS_pubmethodSequenceEqual<T>(IEnumerable<T>, IEqualityComparer<T>)

Sobrecargado. Determina si dos secuencias son iguales al comparar sus elementos mediante un objeto IEqualityComparer<T>.(Definido por Enumerable).

System_CAPS_pubmethodSingle<T>()

Sobrecargado. Devuelve el único elemento de una secuencia y produce una excepción si no hay exactamente un elemento en la secuencia.(Definido por Enumerable).

System_CAPS_pubmethodSingle<T>(Func<T, Boolean>)

Sobrecargado. Devuelve el único elemento de una secuencia que cumpla una condición especificada y produce una excepción si existe más de un elemento de este tipo.(Definido por Enumerable).

System_CAPS_pubmethodSingleOrDefault<T>()

Sobrecargado. Devuelve el único elemento de una secuencia o un valor predeterminado si la secuencia está vacía; Este método produce una excepción si hay más de un elemento en la secuencia.(Definido por Enumerable).

System_CAPS_pubmethodSingleOrDefault<T>(Func<T, Boolean>)

Sobrecargado. Devuelve el único elemento de una secuencia que cumpla la condición especificada, o bien, un valor predeterminado si ese elemento no existe; este método produce una excepción si varios elementos cumplen la condición.(Definido por Enumerable).

System_CAPS_pubmethodSkip<T>(Int32)

Omite un número especificado de elementos de una secuencia y, a continuación, devuelve los elementos restantes.(Definido por Enumerable).

System_CAPS_pubmethodSkipWhile<T>(Func<T, Boolean>)

Sobrecargado. Omite los elementos de una secuencia siempre que una condición especificada sea true y, a continuación, devuelve los elementos restantes.(Definido por Enumerable).

System_CAPS_pubmethodSkipWhile<T>(Func<T, Int32, Boolean>)

Sobrecargado. Omite los elementos de una secuencia siempre que una condición especificada sea true y, a continuación, devuelve los elementos restantes. El índice del elemento se usa en la lógica de la función de predicado.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Decimal>)

Sobrecargado. Calcula la suma de la secuencia de Decimal valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Double>)

Sobrecargado. Calcula la suma de la secuencia de Double valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Int32>)

Sobrecargado. Calcula la suma de la secuencia de Int32 valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Int64>)

Sobrecargado. Calcula la suma de la secuencia de Int64 valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Nullable<Decimal>>)

Sobrecargado. Calcula la suma de la secuencia de nullable Decimal valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Nullable<Double>>)

Sobrecargado. Calcula la suma de la secuencia de nullable Double valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Nullable<Int32>>)

Sobrecargado. Calcula la suma de la secuencia de nullable Int32 valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Nullable<Int64>>)

Sobrecargado. Calcula la suma de la secuencia de nullable Int64 valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Nullable<Single>>)

Sobrecargado. Calcula la suma de la secuencia de nullable Single valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodSum<T>(Func<T, Single>)

Sobrecargado. Calcula la suma de la secuencia de Single valores que se obtienen mediante la invocación de una función de transformación en cada elemento de la secuencia de entrada.(Definido por Enumerable).

System_CAPS_pubmethodTake<T>(Int32)

Devuelve un número especificado de elementos contiguos desde el principio de una secuencia.(Definido por Enumerable).

System_CAPS_pubmethodTakeWhile<T>(Func<T, Boolean>)

Sobrecargado. Devuelve los elementos de una secuencia siempre que una condición especificada sea true.(Definido por Enumerable).

System_CAPS_pubmethodTakeWhile<T>(Func<T, Int32, Boolean>)

Sobrecargado. Devuelve los elementos de una secuencia siempre que una condición especificada sea true. El índice del elemento se usa en la lógica de la función de predicado.(Definido por Enumerable).

System_CAPS_pubmethodToArray<T>()

Crea una matriz a partir de un IEnumerable<T>.(Definido por Enumerable).

System_CAPS_pubmethodToDictionary<T, TKey>(Func<T, TKey>)

Sobrecargado. Crea un Dictionary<TKey, TValue> de un IEnumerable<T> según una función del selector de claves especificada.(Definido por Enumerable).

System_CAPS_pubmethodToDictionary<T, TKey>(Func<T, TKey>, IEqualityComparer<TKey>)

Sobrecargado. Crea un Dictionary<TKey, TValue> de un IEnumerable<T> según un comparador de función y la clave del selector de claves especificada.(Definido por Enumerable).

System_CAPS_pubmethodToDictionary<T, TKey, TElement>(Func<T, TKey>, Func<T, TElement>)

Sobrecargado. Crea un Dictionary<TKey, TValue> de un IEnumerable<T> según el selector de claves especificada y las funciones del selector de elementos.(Definido por Enumerable).

System_CAPS_pubmethodToDictionary<T, TKey, TElement>(Func<T, TKey>, Func<T, TElement>, IEqualityComparer<TKey>)

Sobrecargado. Crea un Dictionary<TKey, TValue> de un IEnumerable<T> según una función del selector de claves especificada, un comparador y una función del selector de elementos.(Definido por Enumerable).

System_CAPS_pubmethodToList<T>()

Crea un List<T> a partir de un IEnumerable<T>.(Definido por Enumerable).

System_CAPS_pubmethodToLookup<T, TKey>(Func<T, TKey>)

Sobrecargado. Crea un Lookup<TKey, TElement> de un IEnumerable<T> según una función del selector de claves especificada.(Definido por Enumerable).

System_CAPS_pubmethodToLookup<T, TKey>(Func<T, TKey>, IEqualityComparer<TKey>)

Sobrecargado. Crea un Lookup<TKey, TElement> de un IEnumerable<T> según un comparador de función y la clave del selector de claves especificada.(Definido por Enumerable).

System_CAPS_pubmethodToLookup<T, TKey, TElement>(Func<T, TKey>, Func<T, TElement>)

Sobrecargado. Crea un Lookup<TKey, TElement> de un IEnumerable<T> según el selector de claves especificada y las funciones del selector de elementos.(Definido por Enumerable).

System_CAPS_pubmethodToLookup<T, TKey, TElement>(Func<T, TKey>, Func<T, TElement>, IEqualityComparer<TKey>)

Sobrecargado. Crea un Lookup<TKey, TElement> de un IEnumerable<T> según una función del selector de claves especificada, un comparador y una función del selector de elementos.(Definido por Enumerable).

System_CAPS_pubmethodUnion<T>(IEnumerable<T>)

Sobrecargado. Proporciona la unión de conjunto de dos secuencias utilizando el comparador de igualdad predeterminado.(Definido por Enumerable).

System_CAPS_pubmethodUnion<T>(IEnumerable<T>, IEqualityComparer<T>)

Sobrecargado. Proporciona la unión de conjuntos de dos secuencias mediante un objeto IEqualityComparer<T>.(Definido por Enumerable).

System_CAPS_pubmethodWhere<T>(Func<T, Boolean>)

Sobrecargado. Filtra una secuencia de valores en función de un predicado.(Definido por Enumerable).

System_CAPS_pubmethodWhere<T>(Func<T, Int32, Boolean>)

Sobrecargado. Filtra una secuencia de valores en función de un predicado. El índice de cada elemento se usa en la lógica de la función de predicado.(Definido por Enumerable).

System_CAPS_pubmethodZip<T, TSecond, TResult>(IEnumerable<TSecond>, Func<T, TSecond, TResult>)

Se aplica a una función especificada a los elementos correspondientes de dos secuencias, que produce una secuencia de los resultados.(Definido por Enumerable).

System_CAPS_noteNota

Para ver el código fuente de .NET Framework para este tipo, consulte el Reference Source. Puede examinar el código fuente en línea, descargue la referencia para verla sin conexión y recorrer (incluidas las revisiones y actualizaciones) durante la depuración; see instructions.

La List<T> clase es el equivalente genérico de la ArrayList clase. Implementa el IList<T> interfaz genérica mediante una matriz cuyo tamaño aumenta dinámicamente cuando es necesario.

Puede agregar elementos a un List<T> utilizando el Add o AddRange métodos.

La List<T> clase usa un comparador de igualdad y un comparador de orden.

  • Métodos como Contains, IndexOf, LastIndexOf, y Remove utilizan un comparador de igualdad para los elementos de lista. El comparador de igualdad predeterminado para el tipo T se determina como sigue. Si tipo T implementa el IEquatable<T> interfaz genérica, el comparador de igualdad es el Equals(T) método de dicha interfaz; en caso contrario, el comparador de igualdad predeterminado es Object.Equals(Object).

  • Métodos como BinarySearch y Sort utilizan un comparador de orden para los elementos de lista. El comparador predeterminado para el tipo T se determina como sigue. Si tipo T implementa el IComparable<T> interfaz genérica, el comparador predeterminado es la CompareTo(T) método de dicha interfaz; en caso contrario, si tipo T implementa la no genérica IComparable interfaz, el comparador predeterminado es la CompareTo(Object) método de dicha interfaz. Si tipo T no implementa ninguna interfaz, entonces no hay ningún comparador predeterminado y debe proporcionarse explícitamente un delegado de comparación o comparador.

El List<T> no se garantiza que se va a ordenar. Debe ordenar la List<T> antes de realizar operaciones (como BinarySearch) que requieren el List<T> esté ordenada.

Pueden tener acceso a los elementos de esta colección utilizando un índice entero. Índices de esta colección son de base cero.

Para grandes List<T> objetos, puede aumentar la capacidad máxima de 2 millones de elementos en un sistema de 64 bits estableciendo la enabled atributo del elemento de configuración a true en el entorno de tiempo de ejecución.

List<T> acepta null como un valor válido para la referencia de tipos y permite elementos duplicados.

Para obtener una versión inmutable de la List<T> de clases, consulte ImmutableList<T>.

Decidir si utilizar el List<T> o ArrayList (clase), que tienen una funcionalidad similar, recuerde que la List<T> clase funciona mejor en la mayoría de los casos y seguridad de tipos. Si se utiliza un tipo de referencia de tipo T de la List<T> (clase), el comportamiento de las dos clases es idéntico. Sin embargo, si se utiliza un tipo de valor de tipo T, debe tener en cuenta los problemas de implementación y la conversión boxing.

Si se utiliza un tipo de valor de tipo T, el compilador genera una implementación de la List<T> específicamente para ese tipo de valor. Es decir, un elemento de lista de un List<T> objeto no tiene que aplicar la conversión boxing antes de que el elemento se puede utilizar, y después de unos 500 elementos de lista se crean la memoria que se guarda no conversión boxing de los elementos de lista es mayor que la memoria utilizada para generar la implementación de la clase.

Compruebe el tipo de valor utilizado para el tipo T implementa el IEquatable<T> interfaz genérica. Si no, los métodos como Contains debe llamar a la Object.Equals(Object) método, que los cuadros del elemento de lista afectado. Si el tipo de valor implementa la IComparable interfaz y posee el código fuente, también implementan la IComparable<T> interfaz genérica para evitar el BinarySearch y Sort métodos de conversión boxing de los elementos de lista. Si no dispone del código fuente, pasar un IComparer<T> de objeto para el BinarySearch y Sort métodos

Es una ventaja de usar la implementación específica del tipo de la List<T> clase en lugar de utilizar la ArrayList clase o escribir una colección de contenedor fuertemente tipado usted mismo. El motivo es que la propia implementación debe hacer lo que .NET Framework ya realiza por usted, y common language runtime puede compartir código de lenguaje intermedio de Microsoft y los metadatos, que su implementación no puede hacer.

La List<T> clase se utiliza con poca frecuencia en el código de F #. En su lugar, Lists (F#), que son listas inmutables vinculadas individualmente, se suele preferir. Una lista de F # proporciona una serie ordenada e inmutable de valores y se puede usar en el desarrollo de estilo funcional. Cuando se utiliza en F #, laList<T> clase normalmente se conoce por el ResizeArray<'T> escriba abreviatura para evitar conflictos con listas de F #

En el ejemplo siguiente se muestra cómo agregar, quitar e insertar un objeto comercial simple en un List<T>.

using System;
using System.Collections.Generic;
// Simple business object. A PartId is used to identify the type of part 
// but the part name can change. 
public class Part : IEquatable<Part>
    {
        public string PartName { get; set; }

        public int PartId { get; set; }

        public override string ToString()
        {
            return "ID: " + PartId + "   Name: " + PartName;
        }
        public override bool Equals(object obj)
        {
            if (obj == null) return false;
            Part objAsPart = obj as Part;
            if (objAsPart == null) return false;
            else return Equals(objAsPart);
        }
        public override int GetHashCode()
        {
            return PartId;
        }
        public bool Equals(Part other)
        {
            if (other == null) return false;
            return (this.PartId.Equals(other.PartId));
        }
    // Should also override == and != operators.

    }
public class Example
{
    public static void Main()
    {
        // Create a list of parts.
        List<Part> parts = new List<Part>();

        // Add parts to the list.
        parts.Add(new Part() {PartName="crank arm", PartId=1234});
        parts.Add(new Part() { PartName = "chain ring", PartId = 1334 });
        parts.Add(new Part() { PartName = "regular seat", PartId = 1434 });
        parts.Add(new Part() { PartName = "banana seat", PartId = 1444 });
        parts.Add(new Part() { PartName = "cassette", PartId = 1534 });
        parts.Add(new Part() { PartName = "shift lever", PartId = 1634 });

        // Write out the parts in the list. This will call the overridden ToString method
        // in the Part class.
        Console.WriteLine();
        foreach (Part aPart in parts)
        {
            Console.WriteLine(aPart);
        }


        // Check the list for part #1734. This calls the IEquitable.Equals method
        // of the Part class, which checks the PartId for equality.
        Console.WriteLine("\nContains(\"1734\"): {0}",
        parts.Contains(new Part {PartId=1734, PartName="" }));

        // Insert a new item at position 2.
        Console.WriteLine("\nInsert(2, \"1834\")");
        parts.Insert(2, new Part() { PartName = "brake lever", PartId = 1834 });


        //Console.WriteLine();
        foreach (Part aPart in parts)
        {
            Console.WriteLine(aPart);
        }

        Console.WriteLine("\nParts[3]: {0}", parts[3]);

        Console.WriteLine("\nRemove(\"1534\")");

        // This will remove part 1534 even though the PartName is different,
        // because the Equals method only checks PartId for equality.
        parts.Remove(new Part(){PartId=1534, PartName="cogs"});

        Console.WriteLine();
        foreach (Part aPart in parts)
        {
            Console.WriteLine(aPart);
        }
        Console.WriteLine("\nRemoveAt(3)");
        // This will remove the part at index 3.
        parts.RemoveAt(3);

        Console.WriteLine();
        foreach (Part aPart in parts)
        {
            Console.WriteLine(aPart);
        }

            /*

             ID: 1234   Name: crank arm
             ID: 1334   Name: chain ring
             ID: 1434   Name: regular seat
             ID: 1444   Name: banana seat
             ID: 1534   Name: cassette
             ID: 1634   Name: shift lever

             Contains("1734"): False

             Insert(2, "1834")
             ID: 1234   Name: crank arm
             ID: 1334   Name: chain ring
             ID: 1834   Name: brake lever
             ID: 1434   Name: regular seat
             ID: 1444   Name: banana seat
             ID: 1534   Name: cassette
             ID: 1634   Name: shift lever

             Parts[3]: ID: 1434   Name: regular seat

             Remove("1534")

             ID: 1234   Name: crank arm
             ID: 1334   Name: chain ring
             ID: 1834   Name: brake lever
             ID: 1434   Name: regular seat
             ID: 1444   Name: banana seat
             ID: 1634   Name: shift lever

             RemoveAt(3)

             ID: 1234   Name: crank arm
             ID: 1334   Name: chain ring
             ID: 1834   Name: brake lever
             ID: 1444   Name: banana seat
             ID: 1634   Name: shift lever


         */

    }
}

En el ejemplo siguiente se muestra varias propiedades y métodos de la List<T> clase genérica de tipo cadena. (Para obtener un ejemplo de un List<T> de tipos complejos, vea la Contains método.)

El constructor predeterminado se utiliza para crear una lista de cadenas con la capacidad predeterminada. El Capacity se muestra la propiedad y, a continuación, el Add método se usa para agregar varios elementos. Se enumeran los elementos y el Capacity propiedad se muestra de nuevo, junto con el Count propiedad, para mostrar que ha aumentado la capacidad según sea necesario.

El Contains método se utiliza para comprobar la presencia de un elemento en la lista, el Insert método se utiliza para insertar un nuevo elemento en mitad de la lista y se volverá a mostrar el contenido de la lista.

El valor predeterminado Item propiedad (el indizador en C#) se utiliza para recuperar un elemento, el Remove método se utiliza para quitar la primera instancia del elemento duplicado agregado anteriormente y se muestra el contenido nuevo. El Remove método siempre quita la primera instancia que encuentra.

El TrimExcess método se utiliza para reducir la capacidad para que coincida con el recuento y el Capacity y Count se muestran las propiedades. Si la capacidad no utilizada hubiera sido menos del 10% de la capacidad total, la lista no habría tamaño ha cambiado.

Por último, el Clear método se utiliza para quitar todos los elementos de la lista y el Capacity y Count se muestran las propiedades.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        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");
        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);
        Console.WriteLine("Count: {0}", dinosaurs.Count);

        Console.WriteLine("\nContains(\"Deinonychus\"): {0}",
            dinosaurs.Contains("Deinonychus"));

        Console.WriteLine("\nInsert(2, \"Compsognathus\")");
        dinosaurs.Insert(2, "Compsognathus");

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        // Shows accessing the list using the Item property.
        Console.WriteLine("\ndinosaurs[3]: {0}", dinosaurs[3]);

        Console.WriteLine("\nRemove(\"Compsognathus\")");
        dinosaurs.Remove("Compsognathus");

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        dinosaurs.TrimExcess();
        Console.WriteLine("\nTrimExcess()");
        Console.WriteLine("Capacity: {0}", dinosaurs.Capacity);
        Console.WriteLine("Count: {0}", dinosaurs.Count);

        dinosaurs.Clear();
        Console.WriteLine("\nClear()");
        Console.WriteLine("Capacity: {0}", dinosaurs.Capacity);
        Console.WriteLine("Count: {0}", dinosaurs.Count);
    }
}

/* This code example produces the following output:

Capacity: 0

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Deinonychus
Compsognathus

Capacity: 8
Count: 5

Contains("Deinonychus"): True

Insert(2, "Compsognathus")

Tyrannosaurus
Amargasaurus
Compsognathus
Mamenchisaurus
Deinonychus
Compsognathus

dinosaurs[3]: Mamenchisaurus

Remove("Compsognathus")

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Deinonychus
Compsognathus

TrimExcess()
Capacity: 5
Count: 5

Clear()
Capacity: 5
Count: 0
 */

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 2.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Público estático (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Es seguro realizar varias operaciones de lectura en un List<T>, pero se pueden producir problemas si se modifica la colección mientras se está leyendo. Para garantizar la seguridad de subprocesos, bloquear la colección durante una lectura o la operación de escritura. Para habilitar una colección para tener acceso a varios subprocesos para leer y escribir, debe implementar su propia sincronización. Para las colecciones con sincronización integrada, vea las clases en el System.Collections.Concurrent espacio de nombres. Para una alternativa inherentemente: seguridad de subprocesos, vea la ImmutableList<T> clase.

Volver al principio
Mostrar: