Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
ArrayList (Clase)
Implementa la interfaz IList utilizando una matriz cuyo tamaño aumenta dinámicamente cuando es necesario.
System.Collections.ArrayList
System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection
Ensamblado: mscorlib (en mscorlib.dll)
El tipo ArrayList expone los siguientes miembros.
| Nombre | Descripción | |
|---|---|---|
|
ArrayList() | Inicializa una nueva instancia de la clase ArrayList que está vacía y tiene la capacidad inicial predeterminada. |
|
ArrayList(ICollection) | Inicializa una nueva instancia de la clase ArrayList que contiene elementos copiados de la colección especificada y que tiene la misma capacidad inicial que el número de elementos copiados. |
|
ArrayList(Int32) | Inicializa una nueva instancia de la clase ArrayList que está vacía y tiene la capacidad inicial predeterminada. |
| Nombre | Descripción | |
|---|---|---|
|
Capacity | Obtiene o establece el número de elementos que puede contener el objeto ArrayList. |
|
Count | Obtiene el número de elementos contenido realmente en ArrayList. |
|
IsFixedSize | Obtiene un valor que indica si la clase ArrayList tiene un tamaño fijo. |
|
IsReadOnly | Obtiene un valor que indica si la clase ArrayList es de sólo lectura. |
|
IsSynchronized | Obtiene un valor que indica si el acceso a ArrayList está sincronizado (es seguro para la ejecución de subprocesos). |
|
Item | Obtiene o establece el elemento que se encuentra en el índice especificado. |
|
SyncRoot | Obtiene un objeto que se puede utilizar para sincronizar el acceso a ArrayList. |
| Nombre | Descripción | |
|---|---|---|
|
Adapter | Crea un contenedor de ArrayList para una interfaz IList concreta. |
|
Add | Agrega un objeto al final de ArrayList. |
|
AddRange | Agrega los elementos de ICollection al final de ArrayList. |
|
BinarySearch(Object) | Busca la ArrayList completa ordenada para un elemento utilizando el comparador predeterminado y devuelve el índice de base cero del elemento. |
|
BinarySearch(Object, IComparer) | Busca la ArrayList completa ordenada para un elemento utilizando el comparador especificado y devuelve el índice de base cero del elemento. |
|
BinarySearch(Int32, Int32, Object, IComparer) | Busca un elemento en un intervalo de elementos de la matriz ArrayList utilizando el comparador especificado y devuelve el índice de base cero del elemento. |
|
Clear | Quita todos los elementos de la clase ArrayList. |
|
Clone | Crea una copia superficial del objeto ArrayList. |
|
Contains | Determina si un elemento se encuentra en la clase ArrayList. |
|
CopyTo(Array) | Copia la ArrayList completa en una Array unidimensional compatible, empezando en el principio de la matriz de destino. |
|
CopyTo(Array, Int32) | Copia la matriz ArrayList completa a una matriz Array unidimensional compatible, empezando en el índice especificado de la matriz de destino. |
|
CopyTo(Int32, Array, Int32, Int32) | Copia un intervalo de elementos de ArrayList en una Array unidimensional compatible, empezando en el índice especificado de la matriz de destino. |
|
Equals(Object) | Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object). |
|
Finalize | Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object). |
|
FixedSize(ArrayList) | Devuelve un contenedor de ArrayList con un tamaño fijo. |
|
FixedSize(IList) | Devuelve un contenedor de IList con un tamaño fijo. |
|
GetEnumerator() | Devuelve un enumerador para la ArrayList completa. |
|
GetEnumerator(Int32, Int32) | Devuelve un enumerador para un intervalo de elementos de la matriz ArrayList. |
|
GetHashCode | Actúa como función hash para un tipo concreto. (Se hereda de Object). |
|
GetRange | Devuelve una ArrayList que representa un subconjunto de los elementos de la ArrayList de origen. |
|
GetType | Obtiene el objeto Type de la instancia actual. (Se hereda de Object). |
|
IndexOf(Object) | Busca el Object especificado y devuelve el índice de base cero de la primera aparición en la ArrayList completa. |
|
IndexOf(Object, Int32) | Busca el objeto Object especificado y devuelve el índice de base cero de la primera aparición dentro del intervalo de elementos de la matriz ArrayList que abarca desde el índice especificado hasta el último elemento. |
|
IndexOf(Object, Int32, Int32) | Busca el objeto Object especificado y devuelve el índice de base cero de la primera aparición dentro del intervalo de elementos de la matriz ArrayList que comienza en el índice especificado y contiene el número especificado de elementos. |
|
Insert | Inserta un elemento en la clase ArrayList en el índice especificado. |
|
InsertRange | Inserta los elementos de una colección en ArrayList en el índice especificado. |
|
LastIndexOf(Object) | Busca el Object especificado y devuelve el índice de base cero de la última aparición en la ArrayList completa. |
|
LastIndexOf(Object, Int32) | Busca el objeto Object especificado y devuelve el índice de base cero de la última aparición dentro del intervalo de elementos de la matriz ArrayList que abarca desde el primer elemento hasta el último índice especificado. |
|
LastIndexOf(Object, Int32, Int32) | Busca el objeto Object especificado y devuelve el índice de base cero de la última aparición dentro del intervalo de elementos de la matriz ArrayList que contiene el número de elementos especificado y termina en el índice especificado. |
|
MemberwiseClone | Crea una copia superficial del objeto Object actual. (Se hereda de Object). |
|
ReadOnly(ArrayList) | Devuelve un contenedor de ArrayList de solo lectura. |
|
ReadOnly(IList) | Devuelve un contenedor de IList de solo lectura. |
|
Remove | Quita la primera aparición de un objeto específico de la interfaz ArrayList. |
|
RemoveAt | Quita el elemento en el índice especificado de ArrayList. |
|
RemoveRange | Quita todos los elementos de ArrayList. |
|
Repeat | Devuelve una ArrayList cuyos elementos son copias del valor especificado. |
|
Reverse() | Invierte el orden de los elementos de toda la ArrayList. |
|
Reverse(Int32, Int32) | Invierte el orden de los elementos en el intervalo especificado. |
|
SetRange | Copia los elementos de una colección en un intervalo de elementos de ArrayList. |
|
Sort() | Ordena todos los elementos de ArrayList. |
|
Sort(IComparer) | Ordena los elementos de toda la matriz ArrayList usando el comparador especificado. |
|
Sort(Int32, Int32, IComparer) | Ordena los elementos de un intervalo de elementos de la matriz ArrayList usando el comparador especificado. |
|
Synchronized(ArrayList) | Devuelve un contenedor de la clase ArrayList que está sincronizado (es seguro para subprocesos). |
|
Synchronized(IList) | Devuelve un contenedor de la clase IList que está sincronizado (es seguro para subprocesos). |
|
ToArray() | Copia los elementos de ArrayList en una nueva matriz de Object. |
|
ToArray(Type) | Copia los elementos de la matriz ArrayList a una nueva matriz del tipo de elemento especificado. |
|
ToString | Devuelve una cadena que representa el objeto actual. (Se hereda de Object). |
|
TrimToSize | Establece la capacidad en el número de elementos real de la colección de objetos ArrayList. |
| Nombre | Descripción | |
|---|---|---|
|
AsParallel | Habilita la paralelización de una consulta. (Definido por ParallelEnumerable). |
|
AsQueryable | Convierte una interfaz IEnumerable en IQueryable. (Definido por Queryable). |
|
Cast<TResult> | Convierte los elementos de IEnumerable en el tipo especificado. (Definido por Enumerable). |
|
OfType<TResult> | Filtra los elementos de IEnumerable en función de un tipo especificado. (Definido por Enumerable). |
No se garantiza que la matriz ArrayList esté ordenada. Debe ordenar la matriz ArrayList antes de realizar operaciones (como BinarySearch) que requieren que la matriz ArrayList esté ordenada.
La capacidad de un objeto ArrayList es el número de elementos que puede contener el objeto ArrayList. A medida que se agregan elementos a ArrayList, la capacidad aumenta automáticamente según lo requiera la reasignación. Se puede disminuir la capacidad llamando al método TrimToSize o estableciendo explícitamente la propiedad Capacity.
Se puede obtener acceso a los elementos de esta colección utilizando un índice de tipo entero. Los índices de esta colección están basados en cero.
La colección ArrayList acepta null como valor válido y permite elementos duplicados.
No permite utilizar matrices multidimensionales como elementos en una colección ArrayList.
En el ejemplo de código siguiente se muestra cómo se crea e inicializa un objeto ArrayList y cómo se imprimen sus valores.
using System; using System.Collections; public class SamplesArrayList { public static void Main() { // Creates and initializes a new ArrayList. ArrayList myAL = new ArrayList(); myAL.Add("Hello"); myAL.Add("World"); myAL.Add("!"); // Displays the properties and values of the ArrayList. Console.WriteLine( "myAL" ); Console.WriteLine( " Count: {0}", myAL.Count ); Console.WriteLine( " Capacity: {0}", myAL.Capacity ); Console.Write( " Values:" ); PrintValues( myAL ); } public static void PrintValues( IEnumerable myList ) { foreach ( Object obj in myList ) Console.Write( " {0}", obj ); Console.WriteLine(); } } /* This code produces output similar to the following: myAL Count: 3 Capacity: 4 Values: Hello World ! */
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
ArrayList puede admitir varios sistemas de lectura a la vez, siempre y cuando no se modifique la colección. Para garantizar la seguridad en la ejecución de los subprocesos de ArrayList, todas las operaciones se deben realizar mediante el contenedor devuelto por el método Synchronized.
Enumerar una colección no es intrínsecamente un procedimiento seguro para subprocesos. Incluso cuando una colección está sincronizada, otros subprocesos todavía pueden modificarla, lo que hace que el enumerador produzca una excepción. Para garantizar la seguridad de los subprocesos durante la enumeración, es posible bloquear la colección durante toda la enumeración o detectar las excepciones resultantes de los cambios realizados por otros subprocesos.