Create Method (UserDefinedPropertyDefinition)

In This Topic

Syntax
Exceptions
Remarks
See Also

Creates new property definition.

Syntax

C#
C++/CLI

public static UserDefinedPropertyDefinition Create( 
   Project pProject,
   string strName,
   UserDefinedPropertyDefinition.Enums.ClientType nClient
)

public:
static UserDefinedPropertyDefinition^ Create( 
   Project^ pProject,
   String^ strName,
   UserDefinedPropertyDefinition.Enums.ClientType nClient
)

Parameters

pProject: Project to which definition will be assigned.
strName: Identifying name of the property.
nClient: Possible usage of user-defined property definition.

Return Value

Returns an object which represents new property definition or null if property definition can't be created.

Exceptions

Exception	Description
System.ArgumentNullException	Thrown when parameter is `null`.
System.ArgumentException	Thrown when identifying name is `empty`.
PropertyAlreadyExistsException	Thrown when property definition with this name already exists in the project.
IncorrectNameFormatException	Thrown when identifying name is invalid.
ProjectLockingException	Thrown when project can't be locked in exclusive mode.

Remarks

The identifying name for the property must be unique. We recommend that you start the name with your company code. It may contain upper-case and lower-case letters, numbers and the special characters ".-_&". A number can't be at the beginning of the name. At least one point must be used in the name; however, the point must not be at the beginning or end of the name. The string "EPLAN" at the beginning is not permitted either. Points within the name are treated as substructures and create a sub-level in the tree.

Reference

UserDefinedPropertyDefinition Class
UserDefinedPropertyDefinition Members

Send Feedback