SerializableDynamicObject

When a component in Forms Builder contains properties, which are not defined in a known type, the Model value needs to be bound to an argument of type SerializableDynamicObject[] which is an array of SerializableDynamicObject objects.

Dynamic objects expose properties at run time, instead of at compile time. This enables you to create objects with property names that are not previously defined.

For example, you may have data such as XML or JSON where the members aren’t known ahead of time. The dynamic object type enables you to work with the objects and access their properties at run time.

An object can contain named properties with values that can themselves be objects or arrays. When an object is serializable, it can be converted to a string representation of the object. A string, as a sequence of characters, is easily transported across the Internet through web services. At its destination, it can be deserialized into the original object. The most efficient string representation of an object is a JSON string and is the format mainly used in Forms Builder.

A Dictionary object is used to store information in name/value pairs (sometimes referred to as key and item value).

Since a dynamic object has properties whose names are not known until run time, a dictionary allows us to store the property name as a string (the key) and its value. Its value must be a known primitive type, like a string, integer, byte, etc., because these are easily deserialized. A SerializableDynamicObject has a Dictionary property called “DataDictionary”.