Gets item-property by name.

Namespace:  Aras.IOM
Assembly:  IOM (in IOM.dll) Version: 11.0.0.6296

Syntax

C#
public Item getPropertyItem(
	string propertyName
)
Visual Basic (Declaration)
Public Function getPropertyItem ( _
	propertyName As String _
) As Item
J#
public Item getPropertyItem(
	String propertyName
)
JScript
public function getPropertyItem(
	propertyName : String
) : Item

Parameters

propertyName
Type: System..::.String
Property name.

Return Value

Found item-property. If by some reason an item can't be returned (e.g. 'this.dom' doesn't have a property with the specified name or the property contains just id but type of the item-property is unknown), the method returns null. NOTE: If specified property name is 'id' then the method returns this item.

Remarks

The method tries to find the specified property on the item. If found, the propery may either a) contain child <Item> node or b) contain just id. In case a), the child <Item> node is used for constructing the returned Item; note, that in this case the returned item shares dom with this item. In case b), an attempt is made to construct a simple Item with the following dom: <Item type='...' id='...'><id>...</id></Item> to be returned. Note that in this case, the returned Item doesn't share its dom with this.

Exceptions

ExceptionCondition
System..::.ExceptionThe instance doesn't represent a single item.

See Also