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 Array

 

Proporciona métodos para la creación, manipulación, búsqueda y ordenación de matrices, por lo tanto, sirve como clase base para todas las matrices de Common Language Runtime.

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

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


[SerializableAttribute]
[ComVisibleAttribute(true)]
public abstract class Array : ICloneable, IList, ICollection, 
	IEnumerable, IStructuralComparable, IStructuralEquatable

NombreDescripción
System_CAPS_pubpropertyIsFixedSize

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

System_CAPS_pubpropertyIsReadOnly

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

System_CAPS_pubpropertyIsSynchronized

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

System_CAPS_pubpropertyLength

Obtiene el número total de elementos de todas las dimensiones de Array.

System_CAPS_pubpropertyLongLength

Obtiene un entero de 64 bits que representa el número total de elementos de todas las dimensiones de la Array.

System_CAPS_pubpropertyRank

Obtiene el rango (número de dimensiones) de Array. Por ejemplo, una matriz unidimensional devuelve 1, una matriz bidimensional devuelve 2, y así sucesivamente.

System_CAPS_pubpropertySyncRoot

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

NombreDescripción
System_CAPS_pubmethodSystem_CAPS_staticAsReadOnly<T>(T[])

Devuelve un contenedor de solo lectura para la matriz especificada.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Array, Int32, Int32, Object)

Busca un valor en un intervalo de elementos de una matriz unidimensional y ordenada, usando la interfaz IComparable implementada por cada elemento de la matriz y por el valor especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Array, Int32, Int32, Object, IComparer)

Busca un valor en un intervalo de elementos de una matriz unidimensional y ordenada, usando la interfaz IComparer especificada.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Array, Object)

Busca un elemento específico en toda una matriz unidimensional y ordenada, usando la interfaz IComparable implementada por cada elemento de la matriz y por el objeto especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Array, Object, IComparer)

Busca un valor por toda una matriz unidimensional y ordenada, usando la interfaz IComparer especificada.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch<T>(T[], T)

Busca un elemento específico en una matriz unidimensional ordenada completa, usando la interfaz genérica IComparable<T> que implementan cada elemento de Array y el objeto especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch<T>(T[], T, IComparer<T>)

Busca un valor por toda una matriz unidimensional y ordenada, usando la interfaz genérica IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch<T>(T[], Int32, Int32, T)

Busca un valor en un intervalo de elementos de una matriz unidimensional y ordenada, usando la interfaz genérica IComparable<T> que implementan cada elemento de Array y el valor especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch<T>(T[], Int32, Int32, T, IComparer<T>)

Busca un valor en un intervalo de elementos de una matriz unidimensional y ordenada, usando la interfaz genérica IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticClear(Array, Int32, Int32)

Establece un intervalo de elementos de una matriz en el valor predeterminado de cada tipo de elemento.

System_CAPS_pubmethodClone()

Crea una copia superficial de la colección Array.

System_CAPS_pubmethodSystem_CAPS_staticConstrainedCopy(Array, Int32, Array, Int32, Int32)

Copia un intervalo de elementos de un objeto Array a partir del índice de origen especificado y los pega en otro objeto Array a partir del índice de destino especificado. Garantiza que se deshacen todos los cambios si la copia no se realiza de forma totalmente correcta.

System_CAPS_pubmethodSystem_CAPS_staticConvertAll<TInput, TOutput>(TInput[], Converter<TInput, TOutput>)

Convierte una matriz de un tipo en una matriz de otro tipo.

System_CAPS_pubmethodSystem_CAPS_staticCopy(Array, Array, Int32)

Copia un intervalo de elementos de una matriz Array comenzando en el primer elemento y los pega en otra matriz Array comenzando en el primer elemento. La longitud se especifica como un entero de 32 bits.

System_CAPS_pubmethodSystem_CAPS_staticCopy(Array, Array, Int64)

Copia un intervalo de elementos de una matriz Array comenzando en el primer elemento y los pega en otra matriz Array comenzando en el primer elemento. La longitud se especifica como un entero de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticCopy(Array, Int32, Array, Int32, Int32)

Copia un intervalo de elementos desde una Array empezando por el índice de origen especificado y los pega en otra Array empezando por el índice de destino especificado. La longitud y los índices se especifican como enteros de 32 bits.

System_CAPS_pubmethodSystem_CAPS_staticCopy(Array, Int64, Array, Int64, Int64)

Copia un intervalo de elementos de un objeto Array a partir del índice de origen especificado y los pega en otro objeto Array a partir del índice de destino especificado. La longitud y los índices se especifican como enteros de 64 bits.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copia todos los elementos de la matriz unidimensional actual en la matriz unidimensional especificada, empezando en el índice especificado de la matriz de destino. El índice se especifica como un entero de 32 bits.

System_CAPS_pubmethodCopyTo(Array, Int64)

Copia todos los elementos de la matriz unidimensional actual en la matriz unidimensional especificada, empezando en el índice especificado de la matriz de destino. El índice se especifica como un entero de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32)

Crea una matriz Array unidimensional de la longitud y el Type especificados, con una indización de base cero.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32, Int32)

Crea una matriz Array bidimensional de las longitudes de dimensión y el Type especificados, con una indización de base cero.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32, Int32, Int32)

Crea una Array tridimensional de las longitudes de dimensión y el Type especificados, con una indización de base cero.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32[])

Crea una Array multidimensional de las longitudes de dimensión y el tipo Type especificados, con una indización de base cero. Las longitudes de dimensión se especifican en una matriz de enteros de 32 bits.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int32[], Int32[])

Crea un multidimensionales Array del Type y longitudes, con los límites inferiores especificados de dimensión.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Int64[])

Crea una Array multidimensional de las longitudes de dimensión y el tipo Type especificados, con una indización de base cero. Las longitudes de dimensión se especifican en una matriz de enteros de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticEmpty<T>()

Devuelve una matriz vacía.

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodSystem_CAPS_staticExists<T>(T[], Predicate<T>)

Determina si la matriz especificada contiene elementos que coinciden con 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_pubmethodSystem_CAPS_staticFind<T>(T[], 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 Array.

System_CAPS_pubmethodSystem_CAPS_staticFindAll<T>(T[], Predicate<T>)

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

System_CAPS_pubmethodSystem_CAPS_staticFindIndex<T>(T[], 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 Array que comienza en el índice especificado y contiene el número especificado de elementos.

System_CAPS_pubmethodSystem_CAPS_staticFindIndex<T>(T[], 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 Array que va desde el índice especificado hasta el último elemento.

System_CAPS_pubmethodSystem_CAPS_staticFindIndex<T>(T[], 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 Array.

System_CAPS_pubmethodSystem_CAPS_staticFindLast<T>(T[], 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 Array.

System_CAPS_pubmethodSystem_CAPS_staticFindLastIndex<T>(T[], 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 Array que contiene el número especificado de elementos y termina en el índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticFindLastIndex<T>(T[], 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 Array que va desde el primer elemento hasta el índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticFindLastIndex<T>(T[], 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 Array.

System_CAPS_pubmethodSystem_CAPS_staticForEach<T>(T[], Action<T>)

Realiza la acción especificada en cada elemento de la matriz especificada.

System_CAPS_pubmethodGetEnumerator()

Devuelve una interfaz IEnumerator para la interfaz Array.

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetLength(Int32)

Obtiene un entero de 32 bits que representa el número de elementos de la dimensión especificada de Array.

System_CAPS_pubmethodGetLongLength(Int32)

Obtiene un entero de 64 bits que representa el número de elementos de la dimensión especificada de la Array.

System_CAPS_pubmethodGetLowerBound(Int32)

Obtiene el índice del primer elemento de la dimensión especificada en la matriz.

System_CAPS_pubmethodGetType()

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

System_CAPS_pubmethodGetUpperBound(Int32)

Obtiene el índice del último elemento de la dimensión especificada en la matriz.

System_CAPS_pubmethodGetValue(Int32)

Obtiene el valor de la posición especificada de la matriz Array unidimensional. El índice se especifica como un entero de 32 bits.

System_CAPS_pubmethodGetValue(Int32, Int32)

Obtiene el valor de la posición especificada de la matriz bidimensional Array. Los índices se especifican como enteros de 32 bits.

System_CAPS_pubmethodGetValue(Int32, Int32, Int32)

Obtiene el valor de la posición especificada de la matriz Array tridimensional. Los índices se especifican como enteros de 32 bits.

System_CAPS_pubmethodGetValue(Int32[])

Obtiene el valor de la posición especificada de Array multidimensional. Los índices se especifican en forma de una matriz de enteros de 32 bits.

System_CAPS_pubmethodGetValue(Int64)

Obtiene el valor de la posición especificada de la matriz Array unidimensional. El índice se especifica como un entero de 64 bits.

System_CAPS_pubmethodGetValue(Int64, Int64)

Obtiene el valor de la posición especificada de la Array bidimensional. Los índices se especifican como enteros de 64 bits.

System_CAPS_pubmethodGetValue(Int64, Int64, Int64)

Obtiene el valor de la posición especificada de la Array tridimensional. Los índices se especifican como enteros de 64 bits.

System_CAPS_pubmethodGetValue(Int64[])

Obtiene el valor de la posición especificada de Array multidimensional. Los índices se especifican en forma de una matriz de enteros de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf(Array, Object)

Busca el objeto especificado y devuelve el índice de su primera aparición en una matriz unidimensional.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf(Array, Object, Int32)

Busca el objeto especificado en un intervalo de elementos de la matriz unidimensional y devuelve el índice de su primera aparición. El intervalo se extiende desde un índice especificado hasta el final de la matriz.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf(Array, Object, Int32, Int32)

Busca el objeto especificado en un intervalo de elementos de una matriz unidimensional y devuelve el índice de su primera aparición. El intervalo se extiende desde un índice especificado durante un número especificado de elementos.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf<T>(T[], T)

Busca el objeto especificado y devuelve el índice de su primera aparición en una matriz unidimensional.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf<T>(T[], T, Int32)

Busca el objeto especificado en un intervalo de elementos de la matriz unidimensional y devuelve el índice de su primera aparición. El intervalo se extiende desde un índice especificado hasta el final de la matriz.

System_CAPS_pubmethodSystem_CAPS_staticIndexOf<T>(T[], T, Int32, Int32)

Busca el objeto especificado en un intervalo de elementos de la matriz unidimensional y devuelve el índice de su primera aparición. El intervalo se extiende desde un índice especificado durante un número especificado de elementos.

System_CAPS_pubmethodInitialize()

Inicializa todos los elementos de la matriz Array de tipo de valor llamando al constructor predeterminado del tipo de valor.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf(Array, Object)

Busca el objeto especificado y devuelve el índice de la última aparición en toda la matriz Array unidimensional.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf(Array, Object, Int32)

Busca el objeto especificado y devuelve el índice de la última aparición en el intervalo de elementos de la matriz Array unidimensional que se extiende desde el primer elemento hasta el índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf(Array, Object, Int32, Int32)

Busca el objeto especificado y devuelve el índice de la última aparición dentro del intervalo de elementos de la Array unidimensional que contiene el número especificado de elementos y termina en el índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf<T>(T[], T)

Busca el objeto especificado y devuelve el índice de la última aparición de toda la Array.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf<T>(T[], T, Int32)

Busca el objeto especificado y devuelve el índice de la última aparición en el intervalo de elementos de la Array que se extiende desde el primer elemento hasta el índice especificado.

System_CAPS_pubmethodSystem_CAPS_staticLastIndexOf<T>(T[], T, Int32, Int32)

Busca el objeto especificado y devuelve el índice de la última aparición en el intervalo de elementos de la Array que contiene el número de elementos especificado y termina en el índice especificado.

System_CAPS_protmethodMemberwiseClone()

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

System_CAPS_pubmethodSystem_CAPS_staticResize<T>(T[], Int32)

Cambia el número de elementos de una matriz unidimensional al nuevo tamaño especificado.

System_CAPS_pubmethodSystem_CAPS_staticReverse(Array)

Invierte la secuencia de los elementos de toda la matriz unidimensional Array.

System_CAPS_pubmethodSystem_CAPS_staticReverse(Array, Int32, Int32)

Invierte la secuencia de los elementos de un intervalo de elementos de la Array unidimensional.

System_CAPS_pubmethodSetValue(Object, Int32)

Establece un valor en el elemento situado en la posición especificada de una matriz Array unidimensional. El índice se especifica como un entero de 32 bits.

System_CAPS_pubmethodSetValue(Object, Int32, Int32)

Establece un valor en el elemento situado en la posición especificada de la Array bidimensional. Los índices se especifican como enteros de 32 bits.

System_CAPS_pubmethodSetValue(Object, Int32, Int32, Int32)

Establece un valor en el elemento situado en la posición especificada de la Array tridimensional. Los índices se especifican como enteros de 32 bits.

System_CAPS_pubmethodSetValue(Object, Int32[])

Establece un valor en el elemento situado en la posición especificada de una matriz Array multidimensional. Los índices se especifican en forma de una matriz de enteros de 32 bits.

System_CAPS_pubmethodSetValue(Object, Int64)

Establece un valor en el elemento situado en la posición especificada de una matriz Array unidimensional. El índice se especifica como un entero de 64 bits.

System_CAPS_pubmethodSetValue(Object, Int64, Int64)

Establece un valor en el elemento situado en la posición especificada de la Array bidimensional. Los índices se especifican como enteros de 64 bits.

System_CAPS_pubmethodSetValue(Object, Int64, Int64, Int64)

Establece un valor en el elemento situado en la posición especificada de la Array tridimensional. Los índices se especifican como enteros de 64 bits.

System_CAPS_pubmethodSetValue(Object, Int64[])

Establece un valor en el elemento situado en la posición especificada de una matriz Array multidimensional. Los índices se especifican en forma de una matriz de enteros de 64 bits.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array)

Ordena los elementos de toda una matriz Array unidimensional usando la implementación de IComparable de cada elemento de la matriz Array.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Array)

Ordena un par de objetos Array unidimensionales (uno contiene las claves y el otro contiene los elementos correspondientes) en función de las claves de la primera Array usando la implementación de IComparable de cada clave.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Array, IComparer)

Ordena un par de objetos Array unidimensionales (uno contiene las claves y el otro contiene los elementos correspondientes) en función de las claves de la primera Array usando la IComparer. especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Array, Int32, Int32)

Ordena un intervalo de elementos en un par de objetos Array unidimensionales (uno contiene las claves y el otro contiene los elementos correspondientes) en función de las claves de la primera matriz Array usando la implementación de IComparable de cada clave.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Array, Int32, Int32, IComparer)

Ordena un intervalo de elementos de un par de objetos Array unidimensionales (uno contiene las claves y el otro contiene los elementos correspondientes) en función de las claves de la primera Array usando la interfaz IComparer especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, IComparer)

Ordena los elementos de una matriz Array unidimensional usando la interfaz IComparer especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Int32, Int32)

Ordena los elementos de un intervalo de elementos de una matriz Array unidimensional mediante el uso de la implementación de IComparable de cada elemento de la matriz Array.

System_CAPS_pubmethodSystem_CAPS_staticSort(Array, Int32, Int32, IComparer)

Ordena los elementos de un intervalo de elementos de un unidimensional Array usando el objeto IComparer.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[])

Ordena los elementos de toda una matriz Array usando la implementación de la interfaz genérica IComparable<T> de cada elemento de Array.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[], Comparison<T>)

Ordena los elementos de una Array usando el Comparison<T> especificado.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[], IComparer<T>)

Ordena los elementos de una Array usando la interfaz genérica IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[], Int32, Int32)

Ordena los elementos en un intervalo de elementos en una Array mediante la implementación de interfaz genérica IComparable<T> de cada elemento de la Array.

System_CAPS_pubmethodSystem_CAPS_staticSort<T>(T[], Int32, Int32, IComparer<T>)

Ordena los elementos de un intervalo de elementos en un elemento Array mediante la interfaz genérica IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort<TKey, TValue>(TKey[], TValue[])

Ordena un par de objetos Array (uno contiene las claves y el otro contiene los elementos correspondientes) en función de las claves de la primera Array usando la implementación de la interfaz genérica IComparable<T> de cada clave.

System_CAPS_pubmethodSystem_CAPS_staticSort<TKey, TValue>(TKey[], TValue[], IComparer<TKey>)

Ordena un par de objetos Array (uno contiene las claves y el otro contiene los elementos correspondientes) en función de las claves de la primera matriz Array usando la interfaz genérica IComparer<T> especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort<TKey, TValue>(TKey[], TValue[], Int32, Int32)

Ordena un intervalo de elementos en un par de objetos Array (uno contiene las claves y el otro contiene los elementos correspondientes) en función de las claves de la primera matriz Array usando la implementación de la interfaz genérica IComparable<T> de cada clave.

System_CAPS_pubmethodSystem_CAPS_staticSort<TKey, TValue>(TKey[], TValue[], Int32, Int32, IComparer<TKey>)

Ordena un intervalo de elementos de un par de objetos Array (uno contiene las claves y el otro contiene los elementos correspondientes) en función de las claves de la primera matriz Array usando la interfaz genérica IComparer<T> especificada.

System_CAPS_pubmethodToString()

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

System_CAPS_pubmethodSystem_CAPS_staticTrueForAll<T>(T[], Predicate<T>)

Determina si cada elemento de la matriz cumple las condiciones definidas por el predicado especificado.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Llamar a este método siempre produce una NotSupportedException excepción.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Clear()

Quita todos los elementos de IList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Contains(Object)

Determina si un elemento se encuentra en IList.

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_privmethodIList.RemoveAt(Int32)

Quita el elemento de la interfaz IList que se encuentra en el índice especificado.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralComparable.CompareTo(Object, IComparer)

Determina si el objeto de colección actual precede o sigue a otro objeto en el criterio de ordenación, o aparece en la misma posición que él.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralEquatable.Equals(Object, IEqualityComparer)

Determina si un objeto especificado es igual a la instancia actual.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralEquatable.GetHashCode(IEqualityComparer)

Devuelve un código hash de la instancia actual.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.Count

Obtiene el número de elementos incluidos en Array.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.

NombreDescripción
System_CAPS_pubmethodAsParallel()

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_pubmethodCast<TResult>()

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

System_CAPS_pubmethodOfType<TResult>()

Filtra los elementos de un IEnumerable basado en un tipo especificado.(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 Array clase no es parte de la System.Collections los espacios de nombres. Sin embargo, todavía se considera una colección porque se basa en el IList interfaz.

La Array clase es la clase base para las implementaciones de lenguajes que admiten matrices. Sin embargo, el sistema y los compiladores pueden derivar explícitamente de la Array clase. Los usuarios deben utilizar los constructores de matriz proporcionados por el lenguaje.

Un elemento es un valor en un Array. La longitud de un Array es el número total de elementos que puede contener. El límite inferior de una Array es el índice de su primer elemento. Un Array puede tener cualquier límite inferior, pero tiene un límite inferior de cero de forma predeterminada. Se puede definir al crear una instancia de la Array mediante la clase CreateInstance. Multidimensional Array puede tener distintos límites para cada dimensión. Una matriz puede tener un máximo de 32 dimensiones.

A diferencia de las clases en el System.Collections espacios de nombres, Array tiene una capacidad fija. Para aumentar la capacidad, debe crear un nuevo Array de objeto con la capacidad requerida, copiar los elementos de la antigua Array objeto a la nueva y eliminar el antiguo Array.

De forma predeterminada, el tamaño máximo de un Array es de 2 gigabytes (GB). En un entorno de 64 bits, puede evitar la restricción de tamaño estableciendo la enabled atributo de la gcAllowVeryLargeObjects elemento de configuración true en el entorno de tiempo de ejecución. Sin embargo, la matriz todavía estará limitada a un total de elementos de 4 mil millones y a un índice máximo de 0X7FEFFFFF de cualquier dimensión determinada (0X7FFFFFC7 para matrices de bytes y matrices de estructuras de un solo byte).

A partir de .NET Framework 2.0, el Array la clase implementa la System.Collections.Generic.IList<T>, System.Collections.Generic.ICollection<T>, y System.Collections.Generic.IEnumerable<T> interfaces genéricas. Las implementaciones se proporcionan a matrices en tiempo de ejecución y, como resultado, las interfaces genéricas no aparecen en la sintaxis de declaración de la Array clase. Además, no hay ningún temas de referencia para los miembros de interfaz son accesibles convirtiendo una matriz en el tipo de interfaz genérica (implementaciones explícitas de interfaz). El aspecto clave a tener en cuenta al convertir una matriz en una de estas interfaces es que los miembros que permiten agregar, insertar o quitar elementos throw NotSupportedException.

Type objetos proporcionan información sobre las declaraciones de tipo de matriz. Array los objetos con el mismo tipo de matriz comparten el mismo Type objeto.

Type.IsArray y Type.GetElementType no puede devolver los resultados esperados con Array porque si una matriz se convierte al tipo Array, el resultado es un objeto, no una matriz. Es decir, typeof(System.Array).IsArray devuelve false, y typeof(System.Array).GetElementType devuelve null.

El Array.Copy método copia elementos no sólo entre matrices del mismo tipo, sino también entre matrices estándar de tipos distintos, ya que controla automáticamente la conversión de tipos.

Algunos métodos, como CreateInstance, Copy, CopyTo, GetValue, y SetValue, proporcionan sobrecargas que aceptan enteros de 64 bits como parámetros para alojar matrices de gran capacidad. LongLength y GetLongLength devuelven enteros de 64 bits que indica la longitud de la matriz.

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

Mediante un Array no admite el objeto de punteros en código nativo y producirá un NotSupportedException para varios métodos.

El siguiente ejemplo de código muestra cómo Array.Copy copia elementos entre una matriz de tipo entero y una matriz de tipo Object.

using System;
public class SamplesArray  {

    public static void Main()  {

       // Creates and initializes a new integer array and a new Object array.
       int[] myIntArray = new int[5] { 1, 2, 3, 4, 5 };
       Object[] myObjArray = new Object[5] { 26, 27, 28, 29, 30 };

       // Prints the initial values of both arrays.
       Console.WriteLine( "Initially," );
       Console.Write( "integer array:" );
       PrintValues( myIntArray );
       Console.Write( "Object array: " );
       PrintValues( myObjArray );

       // Copies the first two elements from the integer array to the Object array.
       System.Array.Copy( myIntArray, myObjArray, 2 );

       // Prints the values of the modified arrays.
       Console.WriteLine( "\nAfter copying the first two elements of the integer array to the Object array," );
       Console.Write( "integer array:" );
       PrintValues( myIntArray );
       Console.Write( "Object array: " );
       PrintValues( myObjArray );

       // Copies the last two elements from the Object array to the integer array.
       System.Array.Copy( myObjArray, myObjArray.GetUpperBound(0) - 1, myIntArray, myIntArray.GetUpperBound(0) - 1, 2 );

       // Prints the values of the modified arrays.
       Console.WriteLine( "\nAfter copying the last two elements of the Object array to the integer array," );
       Console.Write( "integer array:" );
       PrintValues( myIntArray );
       Console.Write( "Object array: " );
       PrintValues( myObjArray );
    }


    public static void PrintValues( Object[] myArr )  {
       foreach ( Object i in myArr )  {
          Console.Write( "\t{0}", i );
       }
       Console.WriteLine();
    }

    public static void PrintValues( int[] myArr )  {
       foreach ( int i in myArr )  {
          Console.Write( "\t{0}", i );
       }
       Console.WriteLine();
    }
 }
 /* 
 This code produces the following output.

 Initially,
 integer array:  1       2       3       4       5
 Object array:   26      27      28      29      30

 After copying the first two elements of the integer array to the Object array,
 integer array:  1       2       3       4       5
 Object array:   1       2       28      29      30

 After copying the last two elements of the Object array to the integer array,
 integer array:  1       2       3       29      30
 Object array:   1       2       28      29      30
 */

En el ejemplo de código siguiente se crea e inicializa un Array y muestra sus propiedades y sus elementos.

using System;
public class SamplesArray2{

    public static void Main()  {

       // Creates and initializes a new three-dimensional Array of type Int32.
       Array myArr = Array.CreateInstance( typeof(Int32), 2, 3, 4 );
       for ( int i = myArr.GetLowerBound(0); i <= myArr.GetUpperBound(0); i++ )
          for ( int j = myArr.GetLowerBound(1); j <= myArr.GetUpperBound(1); j++ )
             for ( int k = myArr.GetLowerBound(2); k <= myArr.GetUpperBound(2); k++ )  {
                myArr.SetValue( (i*100)+(j*10)+k, i, j, k );
             }

       // Displays the properties of the Array.
       Console.WriteLine( "The Array has {0} dimension(s) and a total of {1} elements.", myArr.Rank, myArr.Length );
       Console.WriteLine( "\tLength\tLower\tUpper" );
       for ( int i = 0; i < myArr.Rank; i++ )  {
          Console.Write( "{0}:\t{1}", i, myArr.GetLength(i) );
          Console.WriteLine( "\t{0}\t{1}", myArr.GetLowerBound(i), myArr.GetUpperBound(i) );
       }

       // Displays the contents of the Array.
       Console.WriteLine( "The Array contains the following values:" );
       PrintValues( myArr );
    }


    public static void PrintValues( Array myArr )  {
       System.Collections.IEnumerator myEnumerator = myArr.GetEnumerator();
       int i = 0;
       int cols = myArr.GetLength( myArr.Rank - 1 );
       while ( myEnumerator.MoveNext() )  {
          if ( i < cols )  {
             i++;
          } else  {
             Console.WriteLine();
             i = 1;
          }
          Console.Write( "\t{0}", myEnumerator.Current );
       }
       Console.WriteLine();
    }
 }
 /* 
 This code produces the following output.

 The Array has 3 dimension(s) and a total of 24 elements.
     Length    Lower    Upper
 0:    2    0    1
 1:    3    0    2
 2:    4    0    3
 The Array contains the following values:
     0    1    2    3
     10    11    12    13
     20    21    22    23
     100    101    102    103
     110    111    112    113
     120    121    122    123
 */

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
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.

Esta implementación no proporciona un sincronizados contenedor (es seguro para subprocesos) para una Array; Sin embargo, las clases de .NET Framework basadas en Array proporcionar su propia versión sincronizada de la colección mediante el SyncRoot propiedad.

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. Con el fin de garantizar la seguridad para la ejecución de subprocesos durante la enumeración, se puede bloquear la colección durante toda la enumeración o detectar las excepciones resultantes de los cambios realizados por otros subprocesos.

Volver al principio
Mostrar: