Information.UBound(Array, Int32) Yöntem

Tanım

Bir dizinin belirtilen boyutu için kullanılabilir en yüksek alt simgeyi döndürür.

public static int UBound(Array Array, int Rank = 1);
static member UBound : Array * int -> int
Public Function UBound (Array As Array, Optional Rank As Integer = 1) As Integer

Parametreler

Array
Array

Gerekli. Herhangi bir veri türünün dizisi. Bir boyutun mümkün olan en yüksek alt indisini bulmak istediğiniz dizi.

Rank
Int32

Optional. Integer. Mümkün olan en yüksek alt indis döndürülecek boyut. İlk boyut için 1, ikinci boyut için 2 vb. kullanın. Atlanırsa Rank , 1 varsayılır.

Döndürülenler

Integer. Belirtilen boyut için alt simgenin içerebileceği en yüksek değer. Yalnızca bir öğe varsa Array , UBound 0 döndürür. Array Sıfır uzunluklu bir dize UBound gibi öğeleri yoksa -1 döndürür.

Özel durumlar

Array, Nothing'e eşittir.

Rank 1'den küçük veya Rank değerinden Arraybüyük.

Örnekler

Aşağıdaki örnekte, bir dizinin belirtilen boyutu için en yüksek kullanılabilir alt simgeyi belirlemek için işlevi kullanılır UBound .

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.

Açıklamalar

Dizi alt indisleri 0'dan başladığından, bir boyutun uzunluğu bu boyut için kullanılabilir en yüksek alt simgeden biri kadar büyük olur.

Aşağıdaki boyutlara sahip bir dizi için aşağıdaki UBound tabloda yer alan değerleri döndürür:

Dim a(100, 5, 4) As Byte
UBound çağrısı Dönüş değeri
UBound(a, 1) 100
UBound(a, 2) 5
UBound(a, 3) 4

Bir dizideki öğelerin toplam sayısını belirlemek için kullanabilirsiniz UBound , ancak alt indislerin 0'da başlaması nedeniyle döndürdüğü değeri ayarlamanız gerekir. Aşağıdaki örnek, önceki örnekte dizinin a toplam boyutunu hesaplar:

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

için total hesaplanan değer 3030'dur ve 101 * 6 * 5'tir.

Şunlara uygulanır

Ayrıca bkz.