Information.UBound(Array, Int32) Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: Information.vb

Quelle:: Information.vb

Quelle:: Information.vb

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 den höchsten verfügbaren Tiefgestellten 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 Arrays mit 0 beginnen, ist die Länge einer Dimension um eins größer als der höchste verfügbare Tiefgestellt für diese Dimension.

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

Dim a(100, 5, 4) As Byte

Aufrufen von UBound	Rückgabewert
`UBound(a, 1)`	100
`UBound(a, 2)`	5
`UBound(a, 3)`	4

Sie können verwenden UBound , 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 Tiefgestellten 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:

Freigeben über