.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+
Row

WorksheetTableDataBinding Interface

Contains information about a Table bound to an external data source or used to create a data source.

Namespace: DevExpress.Spreadsheet

Assembly: DevExpress.Spreadsheet.v21.2.Core.dll

Declaration

public interface WorksheetTableDataBinding :
    WorksheetDataBinding

Remarks

The WorksheetTableDataBinding objects, as well as the WorksheetDataBinding objects, are contained in the WorksheetDataBindingCollection, accessible using the Worksheet.DataBindings property. Cast the item in the collection to the WorksheetTableDataBinding type to obtain the WorksheetTableDataBinding object.

The WorksheetTableDataBinding object is created, added to the Worksheet.DataBindings collection and returned by the WorksheetDataBindingCollection.BindTableToDataSource method. The Table.GetDataSource method also creates a WorksheetTableDataBinding object and adds it to the worksheet’s collection.

When the WorksheetTableDataBinding object is deleted, the associated table remains with its data. When the associated table is deleted, the WorksheetTableDataBinding object is also deleted.

Example

private void BindWeatherReportToTable(object weatherDatasource, CellRange bindingRange) {
    Worksheet sheet = spreadsheetControl1.Document.Worksheets[0];

    // Remove all data bindings bound to the specified data source.
    sheet.DataBindings.Remove(weatherDatasource);

    // Specify the binding options.
    ExternalDataSourceOptions dsOptions = new ExternalDataSourceOptions();
    dsOptions.ImportHeaders = true;
    dsOptions.CellValueConverter = new MyWeatherConverter();
    dsOptions.SkipHiddenRows = true;

    // Create a table and bind the data source to the table.
    try {
        WorksheetTableDataBinding sheetDataBinding = sheet.DataBindings.BindTableToDataSource(weatherDatasource, bindingRange, dsOptions);
        sheetDataBinding.Table.Style = spreadsheetControl1.Document.TableStyles[BuiltInTableStyleId.TableStyleMedium14];

        // Adjust the column width.
        sheetDataBinding.Range.AutoFitColumns();
    }
    catch(Exception e) {
        MessageBox.Show(e.Message, "Binding Exception");
    }
}

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the WorksheetTableDataBinding interface.

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.

See Also