ObjectDataProvider Class

In This Topic

Object Model
Syntax
Remarks
Example
Inheritance Hierarchy
Requirements
See Also

This data provider can be used to access object structures. It is capable to work with the following types/interfaces:

IEnumerable (requires at least one record, though)
IEnumerable<T>
IListSource

The provider can parse empty enumerations as well as long as they are strongly typed. Otherwise, at least one element is required in the enumeration and this first element determines the type that is used for further parsing.

The provider automatically supports sorting as soon as the data source implements the IBindingList interface.

You may also use this data provider to access LINQ query results, as they are IEnumerable<T>.

When using EntityCollection<T> objects as data source the ObjectDataProvider first checks the state of the sub relation by querying the IsLoaded property and dynamically calls Load() if necessary. This way, the data is only queried when needed.

Object Model

Syntax

public sealed class ObjectDataProvider : ICanHandleUsedIdentifiers, IDataProvider, combit.Reporting.ISupportsLogger

public ref class ObjectDataProvider sealed : public ICanHandleUsedIdentifiers, IDataProvider, combit.Reporting.ISupportsLogger

'Declaration
 
Public NotInheritable Class ObjectDataProvider 
   Implements ICanHandleUsedIdentifiers, IDataProvider, combit.Reporting.ISupportsLogger

Remarks

The following options are available to influence the individual properties of the class:

Implement the ITypedList interface in the class to be able to determine names and types implement
Use the DisplayName attribute for the name
Use the FieldType attribute for the type
Use the Browsable(false) attribute to suppress properties

Example

class Car
{
    public string Brand { get; set; }
    public string Model { get; set; }
   
    [FieldType(LlFieldType.PDF)]
    public string FactSheet { get; set; }
   
    [Browsable(false)]
    public double Discount { get; set; }
}

List<Car> cars = new List<Car>();
cars.Add(new Car { Brand = "VW", Model = "Passat", FactSheet = @"c:\temp\VWPassatSheet.pdf", Discount = 10});
cars.Add(new Car { Brand = "Porsche", Model = "Cayenne", FactSheet = @"c:\temp\PorscheCayenneSheet.pdf", Discount = 15});

LL.DataSource = new ObjectDataProvider(cars);
LL.Design();

Inheritance Hierarchy

System.Object
combit.Reporting.DataProviders.ObjectDataProvider

Requirements

Platforms: Windows 10 (Version 21H2 - 23H2), Windows 11 (21H2 - 22H2), Windows Server 2016 - 2022
.NET: .NET Framework 4.8, .NET 6, .NET 8, .NET 9

Reference

ObjectDataProvider Members
combit.Reporting.DataProviders Namespace

Send Feedback