Back to Devexpress

CellRange.GetDataSource(RangeDataSourceOptions) Method

officefileapi-devexpress-dot-spreadsheet-dot-cellrange-dot-getdatasource-x28-devexpress-dot-spreadsheet-dot-rangedatasourceoptions-x29.md

latest5.8 KB
Original Source

CellRange.GetDataSource(RangeDataSourceOptions) Method

Creates the data source from the current cell range using the specified options.

Namespace : DevExpress.Spreadsheet

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

NuGet Package : DevExpress.Spreadsheet.Core

Declaration

csharp
object GetDataSource(
    RangeDataSourceOptions options
)
vb
Function GetDataSource(
    options As RangeDataSourceOptions
) As Object

Parameters

NameTypeDescription
optionsRangeDataSourceOptions

A RangeDataSourceOptions object containing the data source options.

|

Returns

TypeDescription
Object

An object that is the created data source.

|

Remarks

Another method that creates the data source from a worksheet range is the WorksheetDataBindingCollection.CreateDataSource method. It creates a worksheet data binding and adds it to the collection. To obtain a data source associated with a particular binding, use the WorksheetDataBinding.DataSource property.

Example

View Example

csharp
RangeDataSourceOptions options = new RangeDataSourceOptions();
Worksheet sheet = spreadsheetControl1.ActiveWorksheet;
CellRange dataRange = sheet.Selection;
if (dataRange.Equals(sheet.Tables[0].Range))
    options.UseFirstRowAsHeader = true;
else {
    options.UseFirstRowAsHeader = false;
    options.DataSourceColumnTypeDetector = new MyColumnDetector();
}
options.SkipHiddenColumns = true;
rangeDS = dataRange.GetDataSource(options);
sheet.DataBindings.Error += DataBindings_Error;
vb
Dim options As New RangeDataSourceOptions()
Dim sheet As Worksheet = spreadsheetControl1.ActiveWorksheet
Dim dataRange As CellRange = sheet.Selection
If dataRange.Equals(sheet.Tables(0).Range) Then
    options.UseFirstRowAsHeader = True
Else
    options.UseFirstRowAsHeader = False
    options.DataSourceColumnTypeDetector = New MyColumnDetector()
End If
options.SkipHiddenColumns = True
rangeDS = dataRange.GetDataSource(options)
AddHandler sheet.DataBindings.Error, AddressOf DataBindings_Error

The following code snippets (auto-collected from DevExpress Examples) contain references to the GetDataSource(RangeDataSourceOptions) 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.

winforms-spreadsheet-use-cell-range-as-data-source/CS/RangeDataSource/Form1.cs#L38

csharp
options.SkipHiddenColumns = true;
rangeDS = dataRange.GetDataSource(options);
sheet.DataBindings.Error += DataBindings_Error;

wpf-spreadsheet-bind-grid-control-to-worksheet-data/CS/WpfSpreadsheet_DataBinding/MainWindow.xaml.cs#L32

csharp
// Bind the grid control to the table data.
grid.ItemsSource = expensesTable.DataRange.GetDataSource(options);
#endregion #BindGridToSpreadsheetTable

winforms-spreadsheet-use-cell-range-as-data-source/VB/RangeDataSource/Form1.vb#L43

vb
options.SkipHiddenColumns = True
rangeDS = dataRange.GetDataSource(options)
AddHandler sheet.DataBindings.Error, AddressOf DataBindings_Error

wpf-spreadsheet-bind-grid-control-to-worksheet-data/VB/WpfSpreadsheet_DataBinding/MainWindow.xaml.vb#L30

vb
' Bind the grid control to the table data.
            grid.ItemsSource = expensesTable.DataRange.GetDataSource(options)
' #End Region ' #BindGridToSpreadsheetTable

See Also

Data Binding in WinForms Spreadsheet Control

DataBindings

Error

CellRange Interface

CellRange Members

DevExpress.Spreadsheet Namespace