ComponentOne GridView for ASP.NET AJAX: ComponentOne GridView for ASP.NET AJAX Overview > Upgrading From WebGrid for ASP.NET > New Members

New Members

The tables below note some of the classes and members that were added to C1GridView. The new members were primarily added to either enable compatibility with the standard Microsoft GridView control or to support new features such as filtering.

New Events

Two new events have been added to support the filter bar feature:

 

Event

Description

Filtered

Occurs after filter expression is applied to the underlying DataView's RowFilter property.

Filtering

Occurs when the preparation for filtering is started but before the C1GridView instance handles the filter operation.

New Enumerators

Two new enumerators have been added to support the filter bar feature:

 

Enumerator

Description

FilterMode

Gets or sets value indicating whether filtering will be performed automatically or not.

FilterOperator

Gets or sets filter operator used for filtering.

New Properties

The following design and run-time properties have been added to C1GridView. Many of these were added to support the standard Microsoft GridView control and were never included in C1WebGrid:

 

Property

Description

AutoGenerateDeleteButton

Gets or sets a value indicating whether a CommandField field column with a Delete button for each data row is automatically added to a C1GridView control.

AutoGenerateEditButton

Gets or sets a value indicating whether a CommandField field column with an Edit button for each data row is automatically added to a C1GridView control.

AutoGenerateFilterButton

Gets or sets a value indicating whether a CommandField field column with a Filter button for each data row is automatically added to a C1GridView control.

AutoGenerateSelectButton

Gets or sets a value indicating whether a CommandField field column with an Select button for each data row is automatically added to a C1GridView control.

BottomPagerRow

Gets a C1GridViewRow object that represents the bottom pager row in a C1GridView control.

C1WebControlsPath

 

Caption

Gets or sets the text to render in an HTML caption element in a C1GridView control. This property is provided to make the control more accessible to users of assistive technology devices.

CaptionAlign

Gets or sets the horizontal or vertical position of the HTML caption element in a C1GridView control. This property is provided to make the control more accessible to users of assistive technology devices.

EmbeddedVisualStyles

Returns string array with embedded Visual Styles names. (Overrides C1ThemeableCompositeDataBoundControlEmbeddedVisualStyles().)

EmptyDataText

Gets or sets the text to display in the empty data row rendered when a C1GridView control is bound to a data source that does not contain any records.

FilterMode

Gets or sets value indicating whether filtering will be performed automatically or not.

FooterRow

Gets a C1GridViewRow object that represents the footer row in a C1GridView control.

HeaderRow

Gets a C1GridViewRow object that represents the header row in a C1GridView control.

HeaderRows

Gets an array of C1GridViewRow objects that represents the header rows in a C1GridView control.

RowHeaderColumn

Gets or sets the name of the column to use as the column header for the C1GridView control. This property is provided to make the control more accessible to users of assistive technology devices.

SelectedDataKey

Gets the DataKey object that contains the data key value for the selected row in a C1GridView control.

SelectedValue

Gets the data key value of the selected row in a C1GridView control.

ShowFilter

Gets or sets value indicating whether filter row is visible or not.

TopPagerRow

Gets a C1GridViewRow object that represents the top pager row in a C1GridView control.

UseAccessibleHeader

Gets or sets a value indicating whether a C1GridView control renders its header in an accessible format. This property is provided to make the control more accessible to users of assistive technology devices.

UseEmbeddedVisualStyles

 

VisualStyle

Gets or sets the visual style name used by the control. (Overrides C1ThemeableCompositeDataBoundControlVisualStyle().)

VisualStylePath

Gets or sets the path to the visual style folder. (Overrides C1ThemeableCompositeDataBoundControlVisualStylePath().)

New Styles and Settings

The following styles and settings are now available in C1GridView:

 

Property

Description

EmptyDataRowStyle

Gets a reference to the TableItemStyle object that enables you to set the appearance of the empty data row rendered when a C1GridView control is bound to a data source that does not contain any records.

FilterStyle

Gets a reference to the TableItemStyle object that enables you to set the appearance of the filter row in a C1GridView control.

PagerSettings*

Gets a reference to the C1GridViewPagerSettings object that enables you to set the properties of the pager buttons in a C1GridView control.

ResizeSettings

Gets the ResizeSettings object that defines the resizing behavior of the columns on client-side.

RowHeader

Gets a C1RowHeaderField object that represents the row header in a C1GridView control.

ScrollSettings

Gets the scroll setting for the C1GridView control.

 

* C1WebGrid's PagerStyle class has now been broken up into C1GridView's PagerStyle and the new PagerSettings. The commonly used property, Mode, is now found under PagerSettings and contains the following differences:

      Support for two new modes: NextPreviousFirstLast and NumericFirstLast.

      Support for custom navigation link images. Four new properties have been added for this feature: FirstPageImageUrl, LastPageImageUrl, NextPageImageUrl, and PreviousPageImageUrl.


Send comments about this topic to ComponentOne.
Copyright © ComponentOne LLC. All rights reserved.