| List<T> Class |
Represents a strongly typed list of objects that can be accessed by index. Provides methods to search, sort, and manipulate lists.
Inheritance HierarchyNamespace: System.Collections.Generic
Assembly: mscorlib (in mscorlib.dll) Version: 4.0.0.0
SyntaxC#
[SerializableAttribute] public class List<T> : IList<T>, ICollection<T>, IEnumerable<T>, IList, ICollection, IEnumerable
Type Parameters
- T
- The type of elements in the list.
The List< T> type exposes the following members.
Methods| Name | Description | |
|---|---|---|
 | Add | Adds an object to the end of the List<T>. |
| AddRange | Adds the elements of the specified collection to the end of the List<T>. |
| AsReadOnly | Returns a read-only IList< T> wrapper for the current collection. |
| BinarySearch(T) | Searches the entire sorted List< T> for an element using the default comparer and returns the zero-based index of the element. |
| BinarySearch(T, IComparer<T>) | Searches the entire sorted List< T> for an element using the specified comparer and returns the zero-based index of the element. |
| BinarySearch(Int32, Int32, T, IComparer<T>) | Searches a range of elements in the sorted List< T> for an element using the specified comparer and returns the zero-based index of the element. |
| Clear | Removes all elements from the List<T>. |
| Contains | Determines whether an element is in the List<T>. |
| ConvertAll<TOutput> | Converts the elements in the current List< T> to another type, and returns a list containing the converted elements. |
| CopyTo(T[]) | Copies the entire List< T> to a compatible one-dimensional array, starting at the beginning of the target array. |
| CopyTo(T[], Int32) | Copies the entire List< T> to a compatible one-dimensional array, starting at the specified index of the target array. |
| CopyTo(Int32,T[], Int32, Int32) | Copies a range of elements from the List< T> to a compatible one-dimensional array, starting at the specified index of the target array. |
| Equals(Object) | (Inherited from Object.) |
| Exists | Determines whether the List< T> contains elements that match the conditions defined by the specified predicate. |
| Find | Searches for an element that matches the conditions defined by the specified predicate, and returns the first occurrence within the entire List<T>. |
| FindAll | Retrieves all the elements that match the conditions defined by the specified predicate. |
| FindIndex(Predicate<T>) | Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the entire List<T>. |
| FindIndex(Int32, Predicate<T>) | Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the List< T> that extends from the specified index to the last element. |
| FindIndex(Int32, Int32, Predicate<T>) | Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the List< T> that starts at the specified index and contains the specified number of elements. |
| ForEach | Performs the specified action on each element of the List<T>. |
| GetEnumerator | Returns an enumerator that iterates through the List<T>. |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| IndexOf(T) | Searches for the specified object and returns the zero-based index of the first occurrence within the entire List<T>. |
| IndexOf(T, Int32) | Searches for the specified object and returns the zero-based index of the first occurrence within the range of elements in the List< T> that extends from the specified index to the last element. |
| IndexOf(T, Int32, Int32) | Searches for the specified object and returns the zero-based index of the first occurrence within the range of elements in the List< T> that starts at the specified index and contains the specified number of elements. |
| Insert | Inserts an element into the List< T> at the specified index. |
| InsertRange | Inserts the elements of a collection into the List< T> at the specified index. |
 | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| Remove | Removes the first occurrence of a specific object from the List<T>. |
| RemoveAll | Removes all the elements that match the conditions defined by the specified predicate. |
| RemoveAt | Removes the element at the specified index of the List<T>. |
| RemoveRange | Removes a range of elements from the List<T>. |
| Reverse() | Reverses the order of the elements in the entire List<T>. |
| Reverse(Int32, Int32) | Reverses the order of the elements in the specified range. |
| Sort() | Sorts the elements in the entire List< T> using the default comparer. |
| Sort(IComparer<T>) | Sorts the elements in the entire List< T> using the specified comparer. |
| Sort(Comparison<T>) | Sorts the elements in the entire List< T> using the specified Comparison<T>. |
| Sort(Int32, Int32, IComparer<T>) | Sorts the elements in a range of elements in List< T> using the specified comparer. |
| ToArray | Copies the elements of the List< T> to a new array. |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| TrueForAll | Determines whether every element in the List< T> matches the conditions defined by the specified predicate. |
Properties| Name | Description | |
|---|---|---|
 | Capacity | Gets or sets the total number of elements the internal data structure can hold without resizing. |
| Count | Gets the number of elements actually contained in the List<T>. |
See Also