Information.UBound(Array, Int32) Metode

Definisi

Ruang nama:

Microsoft.VisualBasic

Rakitan:

Microsoft.VisualBasic.Core.dll

Sumber:

Information.vb

Mengembalikan subskrip tertinggi yang tersedia untuk dimensi array yang ditunjukkan.

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

Parameter

Array

Array

Required. Array dari jenis data apa pun. Array tempat Anda ingin menemukan subskrip dimensi setingkat mungkin.

Rank

Int32

Optional. Integer. Dimensi tempat subskrip setingkat mungkin akan dikembalikan. Gunakan 1 untuk dimensi pertama, 2 untuk yang kedua, dan seterunya. Jika Rank dihilangkan, 1 diasumsikan.

Mengembalikan

Int32

Integer. Nilai tertinggi yang dapat dimuat subskrip untuk dimensi yang ditentukan. Jika Array hanya memiliki satu elemen, UBound mengembalikan 0. Jika Array tidak memiliki elemen, misalnya jika string panjang nol, UBound mengembalikan -1.

Pengecualian

ArgumentNullException

Array adalah Nothing.

RankException

Rank kurang dari 1, atau Rank lebih besar dari peringkat Array.

Contoh

Contoh berikut menggunakan UBound fungsi untuk menentukan subskrip tertinggi yang tersedia untuk dimensi array yang ditunjukkan.

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.

Keterangan

Karena subskrip array dimulai pada 0, panjang dimensi lebih besar oleh satu dari subskrip tertinggi yang tersedia untuk dimensi tersebut.

Untuk array dengan dimensi berikut, UBound mengembalikan nilai dalam tabel berikut:

Dim a(100, 5, 4) As Byte

Panggilan ke UBound	Mengembalikan nilai
UBound(a, 1)	100
UBound(a, 2)	5
UBound(a, 3)	4

Anda dapat menggunakan UBound untuk menentukan jumlah total elemen dalam array, tetapi Anda harus menyesuaikan nilai yang dikembalikan ke akun untuk fakta bahwa subskrip dimulai pada 0. Contoh berikut menghitung ukuran total array a dalam contoh sebelumnya:

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

Nilai yang dihitung total adalah 3030, yaitu 101 * 6 * 5.

Lihat juga

• LBound(Array, Int32)
• ArgumentException
• RankException
• Pernyataan Dim (Visual Basic)
• Pernyataan ReDim (Visual Basic)