FieldListDockPanel.UpdateDataSource(IDesignerHost) Method

Forcibly updates the structure of data sources currently displayed within this FieldListDockPanel object.

Namespace: DevExpress.XtraReports.UserDesigner

Assembly: DevExpress.XtraReports.v19.1.Extensions.dll

NuGet Package: DevExpress.Win.Reporting

Declaration

C#

public void UpdateDataSource(
    IDesignerHost designerHost
)

VB.NET

Public Sub UpdateDataSource(
    designerHost As IDesignerHost
)

Parameters

Name	Type	Description
designerHost	IDesignerHost	An object implementing the IDesignerHost interface that is used to manage designer transactions and components.

Remarks

Use this method when a report’s data source is changed, but this change isn’t reflected in the Field List, and it is necessary to update the Field List,

Example

The following code demonstrates how to update the Field List in the End-User Report Designer by calling the FieldListDockPanel.UpdateDataSource method after assigning a data source to a report.

This may be required after a report has been assigned a new data source at runtime without adding this data source to the End-User Report Designer host. For example, this situation occurs when binding to a list data source (e.g., ArrayList), as demonstrated in the following sample.

Form1.vb

Private Sub BindReportToData()
    If xrDesignPanel1.Report Is Nothing Then
        Return
    End If
     ' Create a data source and bind it to a report.
    xrDesignPanel1.Report.DataSource = CreateDataSource()

    ' Update the Field List.
    Dim fieldList As FieldListDockPanel = CType(xrDesignDockManager1(DesignDockPanelType.FieldList), FieldListDockPanel)
    Dim host As IDesignerHost = CType(xrDesignPanel1.GetService(GetType(IDesignerHost)), IDesignerHost)
    fieldList.UpdateDataSource(host)
End Sub

Form1.cs

private void BindReportToData() {
    if (xrDesignPanel1.Report == null)
        return;
     // Create a data source and bind it to a report.
    xrDesignPanel1.Report.DataSource = CreateDataSource();

    // Update the Field List.
    FieldListDockPanel fieldList =
        (FieldListDockPanel)xrDesignDockManager1[DesignDockPanelType.FieldList];
    IDesignerHost host = 
        (IDesignerHost)xrDesignPanel1.GetService(typeof(IDesignerHost));
    fieldList.UpdateDataSource(host);
}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the UpdateDataSource(IDesignerHost) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

Reporting_how-to-refresh-the-field-list-in-the-end-user-designer-e1584/CS/Form1.cs#L38

        (IDesignerHost)xrDesignPanel1.GetService(typeof(IDesignerHost));
    fieldList.UpdateDataSource(host);
}

VB.NET

Reporting_how-to-refresh-the-field-list-in-the-end-user-designer-e1584/VB/Form1.vb#L39

    Dim host As IDesignerHost = CType(xrDesignPanel1.GetService(GetType(IDesignerHost)), IDesignerHost)
    fieldList.UpdateDataSource(host)
End Sub