VBArray Object (Windows Scripting

Switch View

VBArray Object

Collapse All

Language Filter

This page is specific to

.NET Framework 3.0

Other versions are also available for the following:

JScript

VBArray Object (Windows Scripting - JScript)

Updated: March 2009

Provides access to Visual Basic safe arrays.

varName = new VBArray(safeArray)

Arguments

varName: Required. The variable name to which the VBArray is assigned.
safeArray: Required. A VBArray value.

Remarks

VBArrays are read-only, and cannot be created directly. The safeArray argument must have obtained a VBArray value before being passed to the VBArray constructor. This can only be done by retrieving the value from an existing ActiveX or other object.

VBArrays can have multiple dimensions. The indices of each dimension can be different. The dimensions method retrieves the number of dimensions in the array; the lbound and ubound methods retrieve the range of indices used by each dimension.

Example

The following example consists of three parts. The first part is VBScript code to create a Visual Basic safe array. The second part is JScript code that converts the Visual Basic safe array to a JScript array. Both of these parts go into the <HEAD> section of an HTML page. The third part is the JScript code that goes in the <BODY> section to run the other two parts.

<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
         document.writeln(k)
         k = k + 1
      Next
      document.writeln("<br />")
   Next
   CreateVBArray = a
End Function
-->
</SCRIPT>

<SCRIPT LANGUAGE="JScript">
<!--
function VBArrayTest(vbarray){
   var a = new VBArray(vbarray);
   var b = a.toArray();
   var i;
   for (i = 0; i < 9; i++) 
   {
      document.writeln(b[i]);
   }
}
-->
</SCRIPT>
</HEAD>

<BODY>
<SCRIPT LANGUAGE="JScript">
<!--
   VBArrayTest(CreateVBArray());
-->
</SCRIPT>
</BODY>

Properties

The VBArray object has no properties.

Methods

dimensions Method | getItem Method | lbound Method | toArray Method | ubound Method

Requirements

Version 3

Reference

Array Object (Windows Scripting - JScript)

Change History

Date	History	Reason
March 2009	Modified newline literal in example.	Content bug fix.

Date

History

Reason

March 2009

Modified newline literal in example.

Content bug fix.