BasicDataGrid

The BasicDataGrid control displays items from a data source in a customizable table. Automatically provides paging and ordering support. You can use the standard Visual Studio DataGrid designer to set up the BasicDataGrid’s style and behavior.

You can use the BasicDataGrid with any bindable data source — not only Kentico data and objects.

Derived from: ASP.NET DataGrid

Tip: If you want to display documents from Kentico in a grid, you can use the CMSDataGrid control, which has built-in support for loading Kentico documents.

Getting started

The following is a step-by-step tutorial that shows how to use the BasicDataGrid control to display a table containing laptops (CMS.Laptop documents) from the sample Corporate Site:

  1. Create a new Web form somewhere in your web project.

  2. Switch to the Design tab and drag a BasicDataGrid control from the toolbox onto the form.

  3. Right-click the BasicDataGrid on the form, select Auto Format… and choose a scheme.

  4. Right-click the BasicDataGrid on the form, select Show Smart Tag and then Property Builder.

    • The BasicDataGrid1 Properties dialog opens.
  5. On the General tab, check Allow sorting.

  6. Switch to the Columns tab and uncheck Create columns automatically at run time.

  7. Add a new Bound Column from the Available columns list to the Selected columns list. Enter the following values into the appropriate fields:

    • Header text: Name
    • Data Field: DocumentSKUName
    • Sort expression: DocumentSKUName
  8. Add another Bound column. Enter the following values in the appropriate fields:

    • Header text: Price
    • Data Field: SKUPrice
    • Sort expression: SKUPrice
  9. Click OK.

  10. Switch to the web form’s code behind and add the following references to the beginning of the code:

    
    
    
    using System.Data;
    
    using CMS.DocumentEngine;
    
    
    
  11. Add the following code to the Page_Load method:

    
    
    
    // Retrieves all CMS.Laptop documents from the Kentico database as a DataSet
    DataSet ds = TreeHelper.SelectNodes("/%", false, "CMS.Laptop", "", "DocumentSKUName", -1, true);
    
    // Assigns the DataSet as the data source of the BasicDataGrid control
    BasicDataGrid1.DataSource = ds;
    BasicDataGrid1.DataBind();
    
    
    
  12. Save the changes to the web form and its code behind file.

  13. Right-click the web form in the Solution explorer and select View in Browser.

The resulting page displays a table similar to the following (depending on the chosen scheme):

Configuration

You can set the following properties for the BasicDataGrid control:

Property name

Description

Sample value

DataBindByDefault

Indicates whether the control automatically performs data binding during the Init event.

HideControlForZeroRows

Indicates whether the control should be hidden when no data is loaded. The default value is False.

ProcessSorting

Indicates whether the control processes the grid sorting in the DataView instead of on the SQL level.

RelatedData

Custom data connected to the object.

SetFirstPageAfterSortChange

Indicates if the page index resets to the first page when sorting is changed.

SortAscending

Indicates whether the grid sorting is in ascending order. The default value is True.

SortField

Gets or sets the sort field. Allows you to set the default sort field.

“NewsReleaseDate”

ZeroRowsText

Text shown when the control is hidden by the HideControlForZeroRows property.

“No records found”

Note: The BasicDataGrid inherits from the ASP.NET DataGrid control, so you can also set any of the base properties.

Appearance and styling

You can modify the appearance of the BasicDataGrid control by setting the standard properties inherited from the ASP.NET DataGrid control.

A common way to set the appearance of DataGrid controls is to assign a skin through the SkinID property. You can define skins in .skin files under individual themes in the App_Themes folder. See the .NET Skins and Themes documentation for more information.