Using Caché Objects - InterSystems Documentation

Properties
You can manipulate a collection property using the methods of the collection object associated
with it. For example, you can perform operations on the Colors property defined earlier, using
the methods provided by the %ListOfDataTypes class:
Do obj.Colors.Insert("Red")
Do obj.Colors.Insert("Green")
Do obj.Colors.Insert("Blue")
7.5.4 Stream Properties
Streams are used to create properties containing large (greater than 32K) amounts of character
or binary data. Binary streams contain the same sort of data as type %Binary, and can hold
large binary objects such as pictures. Character streams contain the same sort of data as type
%String, and are intended for storing large amounts of text. Stream data can be stored in either
an external file or a global, depending on how the property is defined. For example, the following
code defines a binary stream stored as a file, and a character stream stored as a global
(the LOCATION parameter is optional):
Property Image As %FileBinaryStream(LOCATION = "C:/Images");
Property Text As %GlobalCharacterStream(LOCATION = "^MyText");
Streams provide numerous methods for manipulating the data they contain. See the Streams
chapter for more detailed information.
7.5.5 Multidimensional Properties
Properties can be marked as being multidimensional. This gives the instance variable associated
to the property all the characteristics of an array node, upon which array operations like
$ORDER could work. For instance:
Property abc [ MultiDimensional ];
Property abc As %String [ MultiDimensional ];
The following are examples of available operations on abc:
Set x = $DATA(obj.abc)
Set x = $DATA(obj.abc(3))
Set x = $GET(obj.abc(3))
Set x = $ORDER(obj.abc("hello",3))
KILL obj.abc
The property behavior and data type classes are not used to generate methods for multidimensional
properties. Thus, a multidimensional property named Kids has no KidsGet, KidsSet,
or KidsLogicalToDisplay methods. There is no validation on setting a property value.
52 Using Caché Objects