One dimensional Arrays are encoded as a sequence of elements preceded by the number of elements encoded as an Int32 value.

Multi-dimensional Arrays have an encoding that depends on where they are used. When a multi-dimensional Array is the Value of an Attribute it uses the Variant encoding described in 5.2.2.16.

When a multi-dimensional Array is a field of a Structure (see 5.2.6) it shall be encoded with the inline matrix representation as shown in Table 22.

Table 22 – Inline Matrix DataEncoding

Name

Data Type

Description

Dimensions

Int32 []

The length of each dimension.

If any dimension has a length <= 0, then no values are encoded.

The number of dimensions shall be at least 2.

Values

*

The values encoded sequentially according to its built-in data type.

The total number of values is the product of the dimensions.

The mapping of a multidimensional array to a flat list is described in 5.2.2.16.

The inline matrix representation is not supported by earlier versions of this specification. This means any Structure with a field or nested field mapped to an inline matrix is not compatible with the deprecated DataTypeDictionary mechanism, and shall not be included in a DataTypeDictionary.

If an Array is null, then its length is encoded as −1. See 5.1.11 for a discussion of zero-length vs null arrays.