Information.UBound(Array, Int32) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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.