access-report-items-programmatically.md

title	page_title	description	slug	tags	published	position	previous_url
Access Report Items	Accessing Report Items with code	Learn about the available methods you can use to access a Telerik Reporting report item programmatically and find relevant CSharp/VB examples for each method.	telerikreporting/using-reports-in-applications/program-the-report-definition/access-report-items-programmatically	access, report, items, programmatically, code	true	5	/faq-accessing-items

Access Report Items Programmatically

In the examples below we show how to access a report item from within the report and from the invoking application. In the first example let's access a TextBox item from the detail section ItemDataBinding event handler.

Access Report Items from within events

1. Select the detail section in the designer, and in the Properties Window, Events tab, find the ItemDataBinding entry and double-click.

2. The event handler passes in "sender" which is a Telerik.Reporting.Processing.DetailSection that represents the section during processing. Thus you can derive:

   • A DataObject that represents the underlying data for a record being processed.
   • All processing report items.

3. Use the ElementTreeHelper.GetChildByName() method to locate an item on the report. In the code example below GetChildByName is used to retrieve "textBox1" TextBox.

In the code example below we are referring to a Processing.TextBox, not Report1.TextBox. The Processing.TextBox represents the TextBox during processing and has a different set of properties than the Report1.TextBox used when defining the report.

{{source=CodeSnippets\CS\API\Telerik\Reporting\Processing\EventsSnippets.cs region=AddSectionDataBindingSnippet}} {{source=CodeSnippets\VB\API\Telerik\Reporting\Processing\EventsSnippets.vb region=AddSectionDataBindingSnippet}}

The ElementTreeHelper may not find the inner Processing report items in ItemDataBinding and NeedDataSource events of the Report item or even in its sections as the Processing tree may not be fully built. In such cases, you may use closer parents or the ItemDataBinding event of the particular report item you try to access.

Access items from the calling application

If we are in the context of a WinForm or WPF Window and we need to access an item from the Report that is shown in a ReportViewer control with an embedded Reporting engine, we can proceed directly following the report hierarchy. We use a report source object of the same type as the report source assigned to the ReportViewer control. Consider the following code:

protected void Button1_Click(object sender, EventArgs e)
{
	Telerik.Reporting.InstanceReportSource instanceReportSource = (Telerik.Reporting.InstanceReportSource)this.reportViewer1.ReportSource;
	Telerik.Reporting.Report report = (Telerik.Reporting.Report)instanceReportSource.ReportDocument;
	Telerik.Reporting.TextBox txt = report.Items.Find("productNameDataTextBox", true)[0] as Telerik.Reporting.TextBox;
}

Protected Sub Button1_Click(sender As Object, e As EventArgs)
	Dim instanceReportSource As Telerik.Reporting.InstanceReportSource = DirectCast(Me.reportViewer1.ReportSource, Telerik.Reporting.InstanceReportSource)
	Dim report As Telerik.Reporting.Report = DirectCast(instanceReportSource.ReportDocument, Telerik.Reporting.Report)
	Dim txt As Telerik.Reporting.TextBox = TryCast(report.Items.Find("productNameDataTextBox", True)(0), Telerik.Reporting.TextBox)
End Sub

Access report fields from a Table item

You can reference the report fields from a table item easily using the Report API hierarchy. Consider the following code:

private void tableTextBox_ItemDataBinding(object sender, EventArgs eventArgs)
{
	//get the textbox from the sender object
	Telerik.Reporting.Processing.TextBox textBox = (Telerik.Reporting.Processing.TextBox)sender;
	//get the table object
	Telerik.Reporting.Processing.Table table = (Telerik.Reporting.Processing.Table)textBox.Parent;
	//get the detail section
	Telerik.Reporting.Processing.DetailSection detail = (Telerik.Reporting.Processing.DetailSection)table.Parent;
	//get the raw value from the Report datasource directly
	textBox.Value = detail.DataObject["Data"];
}

Private Sub tableTextBox_ItemDataBinding(sender As Object, eventArgs As EventArgs)
	'get the textbox from the sender object
	Dim textBox As Telerik.Reporting.Processing.TextBox = DirectCast(sender, Telerik.Reporting.Processing.TextBox)
	'get the table object
	Dim table As Telerik.Reporting.Processing.Table = DirectCast(textBox.Parent, Telerik.Reporting.Processing.Table)
	'get the detail section
	Dim detail As Telerik.Reporting.Processing.DetailSection = DirectCast(table.Parent, Telerik.Reporting.Processing.DetailSection)
	'get the raw value from the Report datasource directly
	textBox.Value = detail.DataObject("Data")
End Sub