Echelon OpenLNS - Manual (Page 656)

OpenLNS Programmer's Reference 619
Accessed Through Connections object.
Interface object.
LonMarkObject object.
Default Property Item
Methods • Add
• ItemByIndex
• ItemByProgammaticName
• Remove
• RemoveByIndex
Properties • ClassId
• Count
• Item
• Parent
• _NewEnum
Methods
The NetworkVariables object contains the following methods .
• Add
• ItemByIndex
• ItemByProgammaticName
• Remove
• RemoveByIndex
Add
Summary Adds a network variable to the collection. You can use this on
NetworkVariables collections that are contained by dynamic
LonMarkObjects , or by custom Interface objects.
The Name and ProgrammaticName properties of the
NetworkVariable object will be set to match the specified
nvName element when this method is called. The name can be a
maximum of 16 characters, and it must not start with a number.
In addition, it cannot include square brackets ([]), commas (,), or
periods (.).
Network variables contained within the same custom Interface
object must have unique user names ( Name property). In
addition, some devices, such as the SmartServer, require that
all network variables within the device have a unique
programmatic name ( ProgrammaticName property). If you
attempt to assign a duplicate user name or programmatic name
to a network variable on such a device or interface, the
operation will fail, and the LCA, #132
lcaErrUniqueNvNameRequired exception will be thrown.
Note that OpenLNS does not check for duplicate network
variable user names when you use the MoveToInterface method
to move a LonMarkObject or NetworkVariable to a custom
interface. You would then only be able to retrieve the first
network variable using the duplicated name from interface. As a
result, make sure all network variables on your network have