ReportItemBase.DataItem property (Telerik.Reporting.Processing) has been replaced by property DataObject

RELATED TO:

Article information

Article relates to

Telerik Reporting Q1 2009+

Created by

Milen, Telerik

Last modified

March 25, 2009

Last modified by

Milen, Telerik

PROBLEM
Starting with 2009 Q1 version of Telerik Reporting Processing.ReportItemBase.DataItem property is made obsolete and Processing.ReportItemBase.DataObject should be used instead.

DESCRIPTION
With the new version of Telerik Reporting - Q1 2009 (v.3.0.9.311) -  we introduced a new high-performing data processing engine that replaced the previous ADO.NET-based one. Although the data operations are transparent for the users, this change reflects on the way the report items are connected to the data from the data source. Thus Telerik Reporting does not depend on System.Data.DataView and System.Data.DataRowView objects any more, but uses its own data model based on the new Telerik.Reporting.Processing.IDataObject interface. The sole purpose of the IDataObjects is to provide unified access to the data from the wide variety of data source objects that Telerik Reporting supports.

SOLUTION
In order to access the data correlated with the processing items (most common in an event handler), one should use the DataObject property. If the processing item has any data associated with it, this property will return an object of type IDataObject that is usually used in a manner similar to the usage of System.Data.DataRowView:

C#
pre-Q1 2009:
private void panel1_ItemDataBound(object sender, System.EventArgs e)  
{  
    Processing.ReportItemBase item = (Processing.ReportItemBase)sender;  
    System.Data.DataRowView drv = (System.Data.DataRowView)item.DataItem; 
    string manufacturer = drv["Manufacturer"] as string;  
} 

Q1 2009 and later:
private void panel1_ItemDataBound(object sender, System.EventArgs e) 
{ 
    Processing.ReportItemBase item = (Processing.ReportItemBase)sender; 
    string manufacturer = item.DataObject["Manufacturer"] as string; 
} 

VB.NET
pre-Q1 2009:
Private Sub panel1_ItemDataBound(sender As Object, e As System.EventArgs) Handles panel1.ItemDataBound 
    Dim item As Processing.ReportItemBase = DirectCast(sender, Processing.ReportItemBase) 
    Dim drv As System.Data.DataRowView = DirectCast(item.DataItem, System.Data.DataRowView) 
    Dim manufacturer As String = TryCast(drv("Manufacturer"), String) 
End Sub 
 

Q1 2009 and later:
Private Sub panel1_ItemDataBound(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles panel1.ItemDataBound 
    Dim item As Processing.ReportItemBase = DirectCast(sender, Processing.ReportItemBase) 
    Dim manufacturer As String = TryCast(item.DataObject("Manufacturer"), String) 
End Sub 


Using the new IDataObject interface you can also access the actual underlying data that was not possible before. The code below demonstrates how to access the current DataRow when binding to a DataTable:

C#
private void detailSection1_ItemDataBound(object sender, EventArgs e) 
{ 
    Processing.ReportItemBase item = (Processing.ReportItemBase)sender; 
    System.Data.DataRow row = (System.Data.DataRow)item.DataObject.RawData; 
 
    // Use the raw object as needed 
    System.Diagnostics.Debug.WriteLine("Row.ProductName: " + row["ProductName"]); 
} 

VB.NET
Private Sub detailSection1_ItemDataBound(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles detailSection1.ItemDataBound 
    Dim item As Processing.ReportItemBase = DirectCast(sender, Processing.ReportItemBase) 
    Dim row As System.Data.DataRow = DirectCast(item.DataObject.RawData, System.Data.DataRow) 
 
    ' Use the raw object as needed 
    System.Diagnostics.Debug.WriteLine("Row.ProductName: " + row("ProductName")) 
End Sub 

When binding to a list of objects you can use IDataObject.RawData to get the current item in this way:

C#
private void panel1_ItemDataBound(object sender, System.EventArgs e) 
{ 
    Processing.ReportItemBase item = (Processing.ReportItemBase)sender; 
    Car car = (Car)item.DataObject.RawData; 
 
    // Use the raw object as needed 
    System.Diagnostics.Debug.WriteLine("Car.Manufacturer: " + car.Manufacturer); 
} 


VB.NET
Private Sub panel1_ItemDataBound(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles panel1.ItemDataBound 
    Dim item As Processing.ReportItemBase = DirectCast(sender, Processing.ReportItemBase) 
    Dim car As Car = DirectCast(item.DataObject.RawData, Car) 
 
    ' Use the raw object as needed 
    System.Diagnostics.Debug.WriteLine("Car.Manufacturer: " + car.Manufacturer) 
End Sub 

Related Products
Telerik Reporting

Resources Buy Try

More Resources

  • Forums

    Find answers to thousands of questions or reach out to our active community

  • Demos

    Invoices, Sales Reports, Dashboards and other reports showcasing what you can accomplish with Telerik Reporting

  • Webinars

    Sign-up for upcoming webinars and watch recorded webinars

  • User Voice

    Get answers directly from the people who build Telerik controls

  • Documentation

    Detailed help articles and API references for Telerik Reporting

  • Knowledge Base

    Tutorials and working examples on how to achieve common scenarios

  • Code Library

    Sample projects submitted by Progress staff and community members

  • Blog

    Stay up-to-date with the latest functionality, how-to articles and industry trends

  • Release History

    Complete release history for Telerik Reporting.

  • System Requirements

    Operating system, .NET and browser support