The requested page is not available for the requested platform. You are viewing the content for Default platform.

XRBindingCollection.Add(String, Object, String) Method

Creates an XRBinding object and adds it to the collection.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

public XRBinding Add(
    string propertyName,
    object dataSource,
    string dataMember
)
Public Function Add(
    propertyName As String,
    dataSource As Object,
    dataMember As String
) As XRBinding

Parameters

Name Type Description
propertyName String

The name of the control's property to bind.

dataSource Object

An object that represents the data source.

dataMember String

A string containing a navigation path resolving to the property of an object.

Returns

Type Description
XRBinding

An XRBinding object.

Examples

The following two methods demonstrate how to add and remove an XRBinding object from the control's collection of data bindings. Data bindings are added in two different ways. For the lbUnitPrice label the binding is first created and then added, for the lbProductName label the binding is created and added simultaneously.

Note that for this example to work correctly, a report must contain the dsProducts dataset, which should use data in the Products table ("SELECT Products.* FROM Products") from the demo Northwind database (nwind.mdb file located in the directory, where you installed DevExpress demos).

using DevExpress.XtraReports.UI;
// ...

public class XtraReport1 : DevExpress.XtraReports.UI.XtraReport {
// ...

    public void AddBindings() {
        // Create a data binding.
        XRBinding binding = new XRBinding("Text", dsProducts1, "Products.UnitPrice");

        // Add the created binding to the binding collection of the lbUnitPrice label.
        lbUnitPrice.DataBindings.Add(binding);

        // Create and add the binding to the binding collection of the lbProductName label.
        lbProductName.DataBindings.Add("Text", dsProducts1, "Products.ProductName");
    }

    public void RemoveBinding(XRControl control, string propertyName) {
        // Get the data binding specified by the control's property name.
        XRBinding binding = control.DataBindings[propertyName];

        // Remove the data binding from the control's binding collection.
        if(binding != null)
            control.DataBindings.Remove(binding);
    }

}
See Also