ClassObjectRelation
Represents a relationship between data objects, providing hierarchical data structure support for data binding scenarios in Telerik WinControls.
Definition
Namespace:Telerik.WinControls
Assembly:Telerik.WinControls.dll
Syntax:
public class ObjectRelationInheritance: objectObjectRelation
Derived Classes:
Properties
ChildRelationNames
Declaration
public virtual string[] ChildRelationNames { get; }Property Value
string[]
ChildRelations
Declaration
public ObjectRelationCollecion ChildRelations { get; }Property Value
Parent
Gets the parent relation of this object relation in the hierarchical structure.
Declaration
public ObjectRelation Parent { get; protected set; }Property Value
The ObjectRelation that is the parent of this relation,
or null if this is a root-level relation.
Remarks
This property enables navigation up the hierarchy in master-detail data scenarios.
ParentRelationNames
Declaration
public virtual string[] ParentRelationNames { get; }Property Value
string[]
Properties
Declaration
public PropertyDescriptorCollection Properties { get; protected set; }Property Value
Tag
Gets or sets an object that contains additional data associated with this relation.
Declaration
public object Tag { get; set; }Property Value
An object that contains data to associate with this relation.
The default value is null.
Remarks
The Tag property can be used to store any additional information that you want to associate with the object relation. This property is not used internally by the ObjectRelation class.
Methods
GetObjectRelation(object)
Creates an appropriate ObjectRelation instance based on the type of the specified list.
Declaration
public static ObjectRelation GetObjectRelation(object list)Parameters
list
The data source object to create a relation for. Can be a BindingSource, DataTable, DataView, or any other enumerable collection.
Returns
An ObjectRelation instance appropriate for the specified data source type. Returns a DataSetObjectRelation for DataTable or DataView objects, otherwise returns a standard ObjectRelation.
Remarks
This factory method automatically determines the most appropriate ObjectRelation type based on the input data source, handling BindingSource unwrapping and DataSet-specific relation creation.
GetObjectRelation(object, string)
Creates an ObjectRelation instance for a specific data member within a data source.
Declaration
public static ObjectRelation GetObjectRelation(object dataSource, string dataMember)Parameters
dataSource
The main data source object containing the data member.
dataMember
The name of the specific data member or table within the data source to create a relation for.
Returns
An ObjectRelation instance for the specified data member, or null
if the data member cannot be resolved.
Remarks
This factory method is useful for creating relations to specific tables within DataSets or other complex data sources that contain multiple related data entities.
Initialize()
Declaration
protected virtual void Initialize()