Owner manual

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