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

 

Publicado: octubre de 2016

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 de este tipo, consulte el origen de referencia.

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


<SerializableAttribute>
<ComVisibleAttribute(True)>
Public MustInherit Class Array
	Implements 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(Of 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(Of T)(T(), T)

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

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Of T)(T(), T, IComparer(Of T))

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

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Of 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(Of T) que implementan cada elemento de Array y el valor especificado.

System_CAPS_pubmethodSystem_CAPS_staticBinarySearch(Of T)(T(), Int32, Int32, T, IComparer(Of T))

Busca un valor en un intervalo de elementos de una matriz unidimensional y ordenada, usando la interfaz genérica IComparer(Of 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(Of TInput, TOutput)(TInput(), Converter(Of 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(Of 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(Of T)(T(), Predicate(Of 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(Of T)(T(), Predicate(Of 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(Of T)(T(), Predicate(Of T))

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

System_CAPS_pubmethodSystem_CAPS_staticFindIndex(Of T)(T(), Int32, Int32, Predicate(Of 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(Of T)(T(), Int32, Predicate(Of 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(Of T)(T(), Predicate(Of 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(Of T)(T(), Predicate(Of 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(Of T)(T(), Int32, Int32, Predicate(Of 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(Of T)(T(), Int32, Predicate(Of 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(Of T)(T(), Predicate(Of 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(Of T)(T(), Action(Of 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(Of 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(Of 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(Of 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(Of 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(Of 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(Of 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(Of 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(Of T)(T())

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

System_CAPS_pubmethodSystem_CAPS_staticSort(Of T)(T(), Comparison(Of T))

Ordena los elementos de una Array usando el Comparison(Of T) especificado.

System_CAPS_pubmethodSystem_CAPS_staticSort(Of T)(T(), IComparer(Of T))

Ordena los elementos de una Array usando la interfaz genérica IComparer(Of T) especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort(Of T)(T(), Int32, Int32)

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

System_CAPS_pubmethodSystem_CAPS_staticSort(Of T)(T(), Int32, Int32, IComparer(Of T))

Ordena los elementos de un intervalo de elementos en un elemento Array mediante la interfaz genérica IComparer(Of T) especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort(Of 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(Of T) de cada clave.

System_CAPS_pubmethodSystem_CAPS_staticSort(Of TKey, TValue)(TKey(), TValue(), IComparer(Of 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(Of T) especificada.

System_CAPS_pubmethodSystem_CAPS_staticSort(Of 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(Of T) de cada clave.

System_CAPS_pubmethodSystem_CAPS_staticSort(Of TKey, TValue)(TKey(), TValue(), Int32, Int32, IComparer(Of 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(Of T) especificada.

System_CAPS_pubmethodToString()

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

System_CAPS_pubmethodSystem_CAPS_staticTrueForAll(Of T)(T(), Predicate(Of 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)

Cuando se llama a este método, siempre se produce una excepción NotSupportedException.

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

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

System_CAPS_pubmethodOfType(Of TResult)()

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

System_CAPS_noteNota

To view the .NET Framework source code for this type, see the Reference Sourcehttp://referencesource.microsoft.com/#mscorlib/system/array.cs#156e066ecc4ccedf. You can browse through the source code online, download the reference for offline viewing, and step through the sources (including patches and updates) during debugging; see instructionshttp://referencesource.microsoft.com/.

The T:System.Array class is not part of the N:System.Collections namespaces. However, it is still considered a collection because it is based on the T:System.Collections.IList interface.

The T:System.Array class is the base class for language implementations that support arrays. However, only the system and compilers can derive explicitly from the T:System.Array class. Users should employ the array constructs provided by the language.

An element is a value in an T:System.Array. The length of an T:System.Array is the total number of elements it can contain. The lower bound of an T:System.Array is the index of its first element. An T:System.Array can have any lower bound, but it has a lower bound of zero by default. A different lower bound can be defined when creating an instance of the T:System.Array class using M:System.Array.CreateInstance(System.Type,System.Int32,System.Int32).A multidimensional T:System.Array can have different bounds for each dimension. An array can have a maximum of 32 dimensions.

Unlike the classes in the N:System.Collections namespaces, T:System.Array has a fixed capacity. To increase the capacity, you must create a new T:System.Array object with the required capacity, copy the elements from the old T:System.Array object to the new one, and delete the old T:System.Array.

By default, the maximum size of an T:System.Array is 2 gigabytes (GB). In a 64-bit environment, you can avoid the size restriction by setting the enabled attribute of the gcAllowVeryLargeObjects configuration element to true in the run-time environment. However, the array will still be limited to a total of 4 billion elements, and to a maximum index of 0X7FEFFFFF in any given dimension (0X7FFFFFC7 for byte arrays and arrays of single-byte structures).

Starting with the .NET Framework 2.0, the T:System.Array class implements the T:System.Collections.Generic.IList`1, T:System.Collections.Generic.ICollection`1, and T:System.Collections.Generic.IEnumerable`1 generic interfaces. The implementations are provided to arrays at run time, and as a result, the generic interfaces do not appear in the declaration syntax for the T:System.Array class. In addition, there are no reference topics for interface members that are accessible only by casting an array to the generic interface type (explicit interface implementations). The key thing to be aware of when you cast an array to one of these interfaces is that members which add, insert, or remove elements throw T:System.NotSupportedException.

Type objects provide information about array type declarations. Array objects with the same array type share the same Type object.

Type.IsArray and Type.GetElementType might not return the expected results with Array because if an array is cast to the type Array, the result is an object, not an array. That is, typeof(System.Array).IsArray returns false, and typeof(System.Array).GetElementType returns null.

The M:System.Array.Copy(System.Array,System.Array,System.Int32) method copies elements not only between arrays of the same type but also between standard arrays of different types; it handles type casting automatically.

Some methods, such as M:System.Array.CreateInstance(System.Type,System.Int32), M:System.Array.Copy(System.Array,System.Array,System.Int32), M:System.Array.CopyTo(System.Array,System.Int32), Overload:System.Array.GetValue, and Overload:System.Array.SetValue, provide overloads that accept 64-bit integers as parameters to accommodate large capacity arrays. P:System.Array.LongLength and M:System.Array.GetLongLength(System.Int32) return 64-bit integers indicating the length of the array.

The T:System.Array is not guaranteed to be sorted. You must sort the T:System.Array prior to performing operations (such as Overload:System.Array.BinarySearch) that require the T:System.Array to be sorted.

Using an T:System.Array object of pointers in native code is not supported and will throw a T:System.NotSupportedException for several methods.

The following code example shows how M:System.Array.Copy(System.Array,System.Array,System.Int32) copies elements between an array of type integer and an array of type T:System.Object.

Public Class SamplesArray

    Public Shared Sub Main()

        ' Creates and initializes a new integer array and a new Object array.
        Dim myIntArray() As Integer = {1, 2, 3, 4, 5}
        Dim myObjArray() As Object = {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(ControlChars.NewLine + "After 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(ControlChars.NewLine + "After 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)
    End Sub

    Public Overloads Shared Sub PrintValues(myArr() As Object)
        Dim i As Object
        For Each i In myArr
            Console.Write(ControlChars.Tab + "{0}", i)
        Next i
        Console.WriteLine()
    End Sub

    Public Overloads Shared Sub PrintValues(myArr() As Integer)
        Dim i As Integer
        For Each i In myArr
            Console.Write(ControlChars.Tab + "{0}", i)
        Next i
        Console.WriteLine()
    End Sub
End Class

' 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

The following code example creates and initializes an T:System.Array and displays its properties and its elements.

Public Class SamplesArray2

    Public Shared Sub Main()

        ' Creates and initializes a new three-dimensional Array of
        ' type Int32.
        Dim myArr As Array = Array.CreateInstance(GetType(Int32), 2, 3, 4)
        Dim i As Integer
        For i = myArr.GetLowerBound(0) To myArr.GetUpperBound(0)
            Dim j As Integer
            For j = myArr.GetLowerBound(1) To myArr.GetUpperBound(1)
                Dim k As Integer
                For k = myArr.GetLowerBound(2) To myArr.GetUpperBound(2)
                    myArr.SetValue(i * 100 + j * 10 + k, i, j, k)
                Next k
            Next j
        Next i ' 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(ControlChars.Tab + "Length" + ControlChars.Tab _
           + "Lower" + ControlChars.Tab + "Upper")
        For i = 0 To myArr.Rank - 1
            Console.Write("{0}:" + ControlChars.Tab + "{1}", i,
               myArr.GetLength(i))
            Console.WriteLine(ControlChars.Tab + "{0}" + ControlChars.Tab _
               + "{1}", myArr.GetLowerBound(i), myArr.GetUpperBound(i))
        Next i

        ' Displays the contents of the Array.
        Console.WriteLine("The Array contains the following values:")
        PrintValues(myArr)
    End Sub

    Public Shared Sub PrintValues(myArr As Array)
        Dim myEnumerator As System.Collections.IEnumerator =
           myArr.GetEnumerator()
        Dim i As Integer = 0
        Dim cols As Integer = myArr.GetLength(myArr.Rank - 1)
        While myEnumerator.MoveNext()
            If i < cols Then
                i += 1
            Else
                Console.WriteLine()
                i = 1
            End If
            Console.Write(ControlChars.Tab + "{0}", myEnumerator.Current)
        End While
        Console.WriteLine()
    End Sub
End Class

' 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

Public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

This implementation does not provide a synchronized (thread safe) wrapper for an T:System.Array; however, .NET Framework classes based on T:System.Array provide their own synchronized version of the collection using the P:System.Array.SyncRoot property.

Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

Volver al principio
Mostrar: