Information.UBound(Array, Int32) Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt den höchsten verfügbaren Feldindex für die angegebene Dimension eines Arrays zurück.

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

Erforderlich. Array eines beliebigen Datentyps. Das Array, in dem der höchste mögliche Feldindex einer Dimension ermittelt werden soll.

Rank: Int32

Dies ist optional. Integer. Die Dimension, für die der höchste mögliche Feldindex zurückgegeben wird. Verwenden Sie für die erste Dimension 1, für die zweite 2 usw. Wird Rank ausgelassen, so wird bei 1 begonnen.

Gibt zurück

Int32

Integer. Der höchste Wert, den der Feldindex für die angegebene Dimension enthalten kann. Wenn Array nur über ein Element verfügt, gibt UBound 0 zurück. Wenn Array keine Elemente enthält, z. B., wenn es eine Zeichenfolge der Länge 0 ist, gibt UBound -1 zurück.

Ausnahmen

ArgumentNullException

Array ist Nothing.

RankException

Rank ist kleiner als 1 oder Rank ist größer als der Rang von Array.

Beispiele

Im folgenden Beispiel wird die UBound Funktion verwendet, um das höchste verfügbare Tiefgestellt für die angegebene Dimension eines Arrays zu ermitteln.

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.

Hinweise

Da Array-Subscripts bei 0 beginnen, ist die Länge einer Dimension um eins größer als der höchste verfügbare Tiefgestellt für diese Dimension.

Für ein Array mit den folgenden Dimensionen UBound gibt die Werte in der folgenden Tabelle zurück:

Dim a(100, 5, 4) As Byte

Anruf bei UBound	Rückgabewert
`UBound(a, 1)`	100
`UBound(a, 2)`	5
`UBound(a, 3)`	4

Sie können UBound verwenden, um die Gesamtzahl der Elemente in einem Array zu bestimmen, aber Sie müssen den zurückgegebenen Wert anpassen, um der Tatsache Rechnung zu tragen, dass die Subscripts bei 0 beginnen. Im folgenden Beispiel wird die Gesamtgröße des Arrays a im vorherigen Beispiel berechnet:

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

Der für total berechnete Wert ist 3030, d. h. 101 * 6 * 5.

Gilt für: