One dimensionalArraysare encoded as a sequence of elements preceded by the number of elements encoded as an Int32value.

Multi-dimensional Arrayshave an encoding that depends on where they are used. When a multi-dimensional Array is the Valueof an Attributeit uses the Variantencoding described in

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

Table 17– Inline Matrix DataEncoding


Data Type



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.



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

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

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