Description

Set or return the name of this McDBNode.

Property type

A String value.  

Syntax

object.Name [= value]

The Name Property syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDBNode.
valueA String value.

Remarks

When setting a name, the new name MUST be unique within the context of the Children of the Parent item. That is, each child McDBNode of a given McDBNode must have a name unique from other Children of its Parent McDBNode). Through symbolic linking, it is possible for the same McDBNode instance to have multiple names (i.e. one for each Children collection it exists in). If an McDBNode is not instanced from a Children context (e.g. it is instanced from McDBDatabase.RetrieveNode with a global Id), it will have its native Name (i.e. the Name specified when the McDBNode was first created).

Exceptions

Error Value Description
E_INVALIDARG &H80070057 The name being assigned is invalid. Either the Name is a duplicate of a name that already exists in Children of the Parent of this McDBNode, you are attempting to rename an Attribute McDBNode, or the Name being assigned contains an invalid character (see Notes).
E_ACCESSDENIED &H80070005 The McDBDatabase.LoggedUser does not have McDBRight.Write permission in the Rights of this McDBNode.
E_UNEXPECTED &H8001FFFF A framework error occurred assigning the Name to this McDBNode.

Notes

Name values may NOT contain back or forward slash characters ("\" or “/”), as they are used to delimit hierarchy levels (in Path and McDBNodes.Item). A Name may also not use an open parenthesis ("(") as its first character, as it indicates an McDBNode.Id reference in McDBNodes.Item. Lastly, an McDBDatabase.RootNode and non-hierarchy nodes (i.e. mcdbNodeAtb attributes) are not allowed to have their names changed.