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

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:

Weitere Informationen