Working with Content Controls
LINQ Reporting Engine enables you to perform certain operations on content controls dynamically while building a report.
Note – To work with content controls in template documents using Microsoft Word®, you may need to show the Developer tab on its ribbon.
Setting Checkbox Values Dynamically
You can set checkbox values to either checked or unchecked in your reports dynamically by taking the following steps:
- Add a checkbox content control to your template at a place where you want it to appear in a result document.
- By editing content control properties, add a
checktag to the title of the checkbox content control using the following syntax.
conditional_expressiondefines a condition upon which the value of the checkbox content control is to be set to checked (or unchecked, if the condition is not met). The conditional expression must return a Boolean value.
While building a report, a conditional expression declared within a
check tag is evaluated and the value of its containing checkbox content control is set accordingly. The
check tag itself is removed then.
Adding Combobox and Dropdown List Items Dynamically
You can dynamically add items to comboboxes and dropdown lists defined in your template by taking the following steps:
- Add a combobox or dropdown list content control to your template at a place where you want it to appear in a result document.
- By editing content control properties, add an item tag to the title of this content control using the following syntax.
<<item [value_expression] [display_name_expression]>>
value_expression defines a value of a combobox or dropdown list item to be added dynamically. This expression is mandatory and must return a non-empty value.
display_name_expression defines a display name of the combobox or dropdown list item to be added. This expression is optional. If it is omitted, then during runtime, a value of
value_expression is used as a display name as well.
Note – Values of both
display_name_expression can be of any types. During runtime,
Object.ToString() is invoked to get textual representations of these expressions’ values.
While building a report,
display_name_expression are evaluated and a corresponding combobox or dropdown list item is added. A declaring item tag is removed then.
item tag causes addition of a single combobox or dropdown list item during runtime. You can add multiple combobox or dropdown list items using multiple
item tags as shown in the following snippet.
<<item ...>><<item ...>>
Also, you can normally use
item tags within data bands to add a combobox or dropdown list item per item of a data collection. For example, given that
clients is a
DataTable instance having a field named “Name”, you can use the following template to cover such a scenario.
<<foreach [client in clients]>><<item [client.Name]>><</foreach>>
item tag can also be combined with an
if tag to add a combobox or dropdown list item depending on a condition as shown in the following snippet.
<<if ...>><<item ...>><</if>>
Existing combobox and dropdown list items are not affected by
item tags. Thus, you can combine both ways of adding combobox and dropdown list items using a template: static and dynamic.
Note – While inserting a combobox or dropdown list, Microsoft Word adds a default item that has to be removed manually, if the item is unwanted.
Setting Content Control Titles Dynamically
You can normally use common expression tags in content control titles, thus forming their contents dynamically. For example, given that
s is a string value, you can set a content control title from this value dynamically by putting the following expression tag into the title.