CopyTo Method (PropertyValue)

In This Topic

Syntax
Exceptions
Example
See Also

Copies property value to destination including all indexes. If source property is indexed destination has to be also indexed. Only indexes from 1 to minimal of both MaxIndex are copied.

Syntax

C#
C++/CLI

public void CopyTo( 
   PropertyValue destination
)

public:
void CopyTo( 
   PropertyValue^ destination
)

Parameters

destination

Exceptions

Exception	Description
NotIndexedPropertyException	Throws when source is indexed and destination isn't indexed property or has static value.
IndexedPropertyException	Throws when source isn't indexed property and destination is indexed.
PropertyTypesMismachException	Throws when source and destination are non-static values and are different types.

Example

PropertyValue oProperty = m_oTestProject.Pages[0].Functions[0].Properties[ FUNC_NON_INDEXED_PROPERTY ];
PropertyValue static_value = "xxx";
static_value.CopyTo ( oProperty ) ; // FUNC_NON_INDEXED_PROPERTY will be changed

PropertyValue oP1 = m_oTestProject.Pages[0].Functions[0].Properties[ FUNC_INDEXED_PROPERTY_1 ];
PropertyValue oP2 = m_oTestProject.Pages[0].Functions[0].Properties[ FUNC_INDEXED_PROPERTY_2 ];
 
// Let say that oP1.Definition.MaxIndex == 100 and oP2.Definition.MaxIndex == 50

oP1.CopyTo ( oP2 ); // all non-empty indexes from 1 to 50 will be copied

UniversalPropertyList ^ UPL = new UniversalPropertyList ( );

PropertyValue up = UPL [ AnyPropertyId ( FUNC_INDEXED_PROPERTY_1 ) ];
oP1.CopyTo ( up );

Reference

PropertyValue Class
PropertyValue Members

Send Feedback