JavaScript 中的 ubound 方法用於回傳 VBArray 在指定維度中所使用的最大索引值。使用方法如下:
safeArray.ubound(dimension)
其中 safeArray 為必選項,是一個 VBArray 物件;dimension 為可選項,代表要取得索引上界的 VBArray 維度,若省略則預設為 1。
如果 VBArray 為空,ubound 方法會回傳 undefined;若 dim 大於 VBArray 的維度或為負數,則會產生「下標越界」的錯誤。
以下示例分為三部分:第一部分是用來建立 Visual Basic 安全陣列的 VBScript 程式碼;第二部分是 JScript 程式碼,用來確定該安全陣列的維度與每一維的上界;這兩部分都放在 HTML 頁面的 <HEAD> 中;第三部分則位於 <BODY>,用來運行前兩部分。
<HEAD>
<SCRIPT LANGUAGE="VBScript">
<!--
Function CreateVBArray()
Dim i, j, k
Dim a(2, 2)
k = 1
For i = 0 To 2
For j = 0 To 2
a(j, i) = k
k = k + 1
Next
Next
CreateVBArray = a
End Function
-->
</SCRIPT>
<SCRIPT LANGUAGE="JScript">
<!--
function VBArrayTest(vba) {
var i, s;
var a = new VBArray(vba);
for (i = 1; i <= a.dimensions(); i++) {
s = "The upper bound of dimension ";
s += i + " is ";
s += a.ubound(i) + ".<br>";
return (s);
}
}
-->
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT language="jscript">
document.write(VBArrayTest(CreateVBArray()));
</SCRIPT>
</BODY>
透過 dimensions() 取得維度數量,再用 ubound() 逐一取出每一維的最大索引,即可掌握整個安全陣列的結構。