UpdateComponent Method

Updates the component's property with the specified value.

Syntax

Visual Basic
C#

'Declaration
 
Public Function UpdateComponent( _
   ByVal component As Object, _
   ByVal propertyName As String, _
   ByVal value As Object _
) As Boolean

public bool UpdateComponent( 
   object component,
   string propertyName,
   object value
)

Parameters

component: The component to be updated - the ActiveReport, Section or ARControl object.
propertyName: The property's name.
value: The new value.

Return Value

True if the property's value is updated successfully; otherwise, false.

Remarks

This method returns false if:

The component parameter is null.
The propertyName parameter is null or empty.
The propertyName is set to DataSource and its value is other than OleDBDataSource, SqlDBDataSource or XMLDataSource.
The AllowChange property in the LayoutChanging event is set to false.
The method's parameter contains a read-only property.
A new property's value is equal to the old one.
An exception occurs at setting the property's value.

Example

VB.NET

Me.arDesigner.UpdateComponent(Me.arDesigner.Report, "PrintWidth", 5.0F)
Me.arDesigner.UpdateComponent(Me.arDesigner.Report.Sections(0), "Height", 4.0F)
Me.arDesigner.UpdateComponent(Me.arDesigner.Report.Sections(0).Controls(0), "Size", New SizeF(1.0F, 1.0F))

this.arDesigner.UpdateComponent(this.arDesigner.Report, "PrintWidth", 5.0f);
this.arDesigner.UpdateComponent(this.arDesigner.Report.Sections[0], "Height", 4.0f);
this.arDesigner.UpdateComponent(this.arDesigner.Report.Sections[0].Controls[0], "Size", new SizeF(1f,1f));

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Designer Class
Designer Members