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

Método Information.UBound (Array, Int32)

 

Publicado: octubre de 2016

Devuelve el mayor subíndice disponible para la dimensión indicada de una matriz.

Espacio de nombres:   Microsoft.VisualBasic
Ensamblado:  Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

public static int UBound(
	Array Array,
	int Rank = 1
)

Parámetros

Array
Type: System.Array

Obligatorio. Matriz de cualquier tipo de datos. La matriz en la que desea buscar el subíndice más alto posible de una dimensión.

Rank
Type: System.Int32

Opcional. Integer. La dimensión para que se devolverá el subíndice más alto posible. Utilice 1 para la primera dimensión, 2 para el segundo y así sucesivamente. Si Rank es se omite, se supone que es 1.

Valor devuelto

Type: System.Int32

Integer. El valor más alto que el subíndice de la dimensión especificada puede contener. Si Array tiene un único elemento, UBound devuelve 0. Si Array no tiene elementos, por ejemplo, si es una cadena de longitud cero, UBound devuelve -1.

Exception Condition
ArgumentNullException

El valor de Array es Nothing.

RankException

Rank es menor que 1, o Rank es mayor que el rango de Array.

Puesto que los subíndices de matriz empiezan en 0, la longitud de una dimensión es mayor en uno que el subíndice más alto disponible para esa dimensión.

Para una matriz con las siguientes dimensiones, UBound devuelve los valores en la tabla siguiente:

Dim a(100, 5, 4) As Byte

Llamada a UBound

Valor devuelto

UBound(a, 1)

100

UBound(a, 2)

5

UBound(a, 3)

4

Puede utilizar UBound para determinar el total número de elementos de una matriz, pero debe ajustar el valor que devuelve en cuenta el hecho de que el subíndice empieza en 0. En el ejemplo siguiente se calcula el tamaño total de la matriz a en el ejemplo anterior:

Dim total As Integer
total = (UBound(A, 1) + 1) * (UBound(A, 2) + 1) * (UBound(A, 3) + 1)

Calcula el valor para total es 3030, que es 101 * 6 * 5.

En el ejemplo siguiente se usa el UBound función para determinar el mayor subíndice disponible para la dimensión indicada de una matriz.

Dim highest, bigArray(10, 15, 20), littleArray(6) As Integer
highest = UBound(bigArray, 1)
highest = UBound(bigArray, 3)
highest = UBound(littleArray)
' The three calls to UBound return 10, 20, and 6 respectively.

.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Volver al principio
Mostrar: