Information.UBound(Array, Int32) Methode
Definition
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 Tiefgestellten für die angegebene Dimension eines Arrays zurück.
public static int UBound(Array Array, int Rank = 1);static member UBound : Array * int -> intPublic Function UBound (Array As Array, Optional Rank As Integer = 1) As IntegerParameter
- Array
- Array
Required. Array eines beliebigen Datentyps. Das Array, in dem Sie den größtmöglichen Tiefgestellt einer Dimension ermitteln möchten.
- Rank
- Int32
Dies ist optional.
Integer. Die Dimension, für die das hochgestellte Tiefgestellt zurückgegeben werden soll. Verwenden Sie für 1 die erste Dimension, 2 für die zweite usw. Wenn Rank nicht angegeben, wird 1 angenommen.
Gibt zurück
Integer. Der höchste Wert, den der Tiefgestellt für die angegebene Dimension enthalten kann. Wenn Array nur ein Element vorhanden ist, UBound wird 0 zurückgegeben. Wenn Array keine Elemente vorhanden sind, z. B. wenn es sich um eine leere Zeichenfolge handelt, UBound wird -1 zurückgegeben.
Ausnahmen
Array ist Nothing.
Rank ist kleiner als 1 oder Rank größer als der Rang von Array.
Beispiele
Im folgenden Beispiel wird die UBound Funktion verwendet, um den höchsten verfügbaren 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 mit 0 beginnen, ist die Länge einer Dimension um einen Wert 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
| Anruf an UBound | Rückgabewert |
|---|---|
UBound(a, 1) |
100 |
UBound(a, 2) |
5 |
UBound(a, 3) |
4 |
Sie können verwenden UBound , um die Gesamtanzahl der Elemente in einem Array zu ermitteln, aber Sie müssen den Wert anpassen, der zurückgegeben wird, um die Tatsache zu berücksichtigen, dass die Tiefstellungen 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 3030 berechnete Wert ist 101 * 6 * 5.