General Information
.NET Subscription
Desktop
Web
Controls and Extensions
Mainteinance Mode
Enterprise and Analytic Tools
Quality Assurance and Productivity
Frameworks and Libraries
DataGridView Members
A data grid view.
Constructors
| Name | Description |
|---|---|
| DataGridView() |
Initializes a new instance of the DataGridView class with default settings. |
Fields
Properties
| Name | Description |
|---|---|
| ActualFilterString |
Gets the string that specifies a filter currently used in the grid. |
| AllowCascadeTreeCreation |
Gets or sets whether the grid performs deferred data loading on start. |
| AllowCascadeUpdate |
Gets or sets whether the grid performs deferred data loading while vertical scrolling. |
| AllowGroupCollapse |
Specifies whether end users can collapse and expand groups of rows. |
| AllowSort |
Specifies whether end users can sort data in the grid. |
| AutoGenerateColumnsMode |
Gets or sets whether columns should be automatically created for fields of the underlying data source, depending on whether the grid contains any columns. |
| BorderColor |
Gets or sets the grid border color. |
| BorderThickness |
Gets or sets the grid border thickness. |
| CellStyle |
Gets or sets the data cell appearance settings. |
| ColumnHeaderContentTemplate |
Gets or sets the template that defines the visual representation of column headers. |
| ColumnHeaderHeight |
Gets or sets the height of column headers in the grid. |
| ColumnHeaderStyle |
Gets or sets the column header appearance settings. |
| Columns |
Provides access to the grid's collection of columns. |
| EditorShowMode |
Gets or sets a gesture by which a user can invoke an in-place editor for a data cell. |
| EndSwipeItems |
Provides access to objects that contain information on action buttons shown on the right side of a data row when a user swipes the row from right to left. |
| FilterExpression |
Gets or sets the grid's filter expression. |
| FilterString |
Gets or sets the grid's filter expression string. |
| FixedColumnSeparatorWidth |
Gets or sets the thickness of the line that separates fixed and scrollable columns. |
| FullSwipeMode |
Specifies whether a full swipe across the row performs the first action from the grid's StartSwipeItems or EndSwipeItems collection. |
| GroupCaptionTemplate |
Gets or sets the template that defines the visual representation of a group row caption. |
| GroupRowHeight |
Gets or sets the height of group rows in the grid. |
| GroupRowStyle |
Gets or sets the group row appearance settings. |
| GroupRowTemplate |
Gets or sets the template that defines the visual representation of group rows. |
| GroupSummaries |
Provides access to the collection of group summary items. |
| GroupSummaryTemplate |
Gets or sets the template that defines the visual representation of summary items displayed within group rows. |
| IndicatorColor |
Gets or sets the color of the load-more (iOS and Android) and pull-to-refresh (iOS only) indicators. |
| IsColumnHeaderVisible |
Specifies whether column headers are shown in the grid. |
| IsEditing | |
| IsGrouped |
Gets whether the grid's data is grouped. |
| IsHorizontalScrollBarVisible |
Gets or sets whether the horizontal scrollbar is shown in the grid. |
| IsLoadMoreEnabled |
Gets or sets whether the load-more functionality is enabled in the grid. |
| IsPullToRefreshEnabled |
Gets or sets whether the pull-to-refresh functionality is enabled in the grid. |
| IsReadOnly |
Gets or sets whether the grid is read-only. |
| IsRefreshing |
Gets or sets whether the grid shows the refresh indicator that provides the pull-to-refresh activity status. |
| IsUpdateLocked |
Gets or sets whether the grid is locked for updating. |
| IsVerticalScrollBarVisible |
Gets or sets whether the vertical scrollbar is shown in the grid. |
| ItemsSource |
Gets or sets the grid's data source. |
| LoadMoreCommand |
Gets or sets the command executed when a user scrolls to the bottom of the grid to load new data items. |
| PullToRefreshCommand |
Gets or sets the command executed when a user pulls the grid down to request content update. |
| RowCount |
Gets the number of data rows in the grid. |
| RowHeight |
Gets or sets the height of data rows in the grid. |
| RowTapCommand |
Gets or sets the command executed when a user taps a row within the grid. |
| SelectedItem |
Returns an object that specifies a data source record to which a data row currently selected in the grid corresponds. |
| SelectedRowHandle |
Gets or sets the selected row handle. |
| SelectionMode |
Gets or sets whether end users can select rows in the grid. |
| ShowGroupedColumns |
Gets or sets whether the grid displays a column used to group data. |
| SortMode |
Specifies whether the grid allows data sorting by multiple columns or by a single column only. |
| StartSwipeItems |
Provides access to objects that contain information on action buttons shown on the left side of a data row when a user swipes the row from left to right. |
| SwipeItemStyle |
Gets or sets the swipe item appearance settings. |
| SwipeItemTemplate |
Gets or sets the template that defines the visual representation of grid's swipe items. |
| TotalSummaries |
Provides access to the collection of total summary items. |
| TotalSummaryHeight |
Gets or sets the total summary panel height. |
| TotalSummaryStyle |
Gets or sets the total summary panel appearance settings. |
| TotalSummaryTemplate |
Gets or sets the template that defines the visual representation of total summary items. |
| TotalSummaryVisibility |
Specifies whether the total summary panel is displayed. |
| VerticalLineThickness |
Gets or sets the thickness of the grid's vertical lines. |
| VisibleColumns |
Gets the collection of visible columns. |
Methods
| Name | Description |
|---|---|
| BeginUpdate() | |
| ClearFilter() |
Clears the filter applied to data in the grid. |
| ClearGrouping() |
Ungroups data in the grid. |
| ClearSorting() |
Clears the sorting applied to the grid. |
| CloseEditor(Boolean) |
Closes a cell in-place editor. |
| CollapseAllGroups() |
Collapses all groups of rows. |
| CollapseGroupRow(Int32) |
Collapses the specified group of rows. |
| DeleteRow(Int32) |
Deletes the specified data row. |
| EndUpdate() | |
| ExpandAllGroups() |
Expands all groups of rows. |
| ExpandGroupRow(Int32) |
Expands the specified group of rows. |
| FindRow(Predicate<IRowData>) |
Returns the handle of the first row that matches the specified criteria. |
| FindRowByValue(String, Object) |
Searches for the value in the column and returns the handle of the corresponding row. |
| GetCellDisplayText(Int32, GridColumn) |
Gets the text displayed within the specified cell. |
| GetCellDisplayText(Int32, String) |
Gets the text displayed within the specified cell. |
| GetCellValue(Int32, GridColumn) |
Gets the value of the specified cell. |
| GetCellValue(Int32, String) |
Gets the value of the specified cell. |
| GetGroup(Int32) |
Provides access to the information on the specified group of rows. |
| GetGroupRowValue(Int32) |
Gets the value of the specified group row. |
| GetRow(Int32) |
Gets an object that provides access to the data of the specified row. |
| GetRowHandle(Int32) |
Returns the handle of the row that corresponds to the specified record in the data source. |
| GetSourceRowIndex(Int32) |
Gets the index of the data source record to which the specified row handle corresponds. |
| GroupBy(GridColumn) |
Groups data in the grid by the specified column. |
| GroupBy(String) |
Groups data in the grid by the specified column. |
| OpenEditor(Int32, String) |
Invokes an in-place editor for the specified cell. |
| ScrollToRow(Int32) |
Scrolls the grid to make the specified row visible. |
| SetCellValue(Int32, GridColumn, Object) |
Assigns a value to the specified cell. |
| SetCellValue(Int32, String, Object) |
Assigns a value to the specified cell. |
| SortBy(GridColumn) |
Sorts data by values of the specified column in ascending order. |
| SortBy(GridColumn, ColumnSortOrder) |
Sorts data by values of the specified column in the specified order. |
| SortBy(GridColumn, ColumnSortOrder, Int32) |
Sorts data by values of the specified column in the specified order, and places the column at the specified position among the sorted columns. |
| SortBy(String) |
Sorts data by values of the column bound to the specified data field in the ascending order. |
Events
| Name | Description |
|---|---|
| AutoGeneratingColumn |
Occurs each time an individual column is generated automatically. |
| CalculateCustomSummary |
Allows you to specify a custom rule to calculate data summaries. |
| CustomUnboundColumnData |
Enables you to populate unbound columns with data, and save changes that users made in unbound columns. |
| CustomizeCellDisplayText |
Allows you to provide a custom display text for any data cell. |
| DoubleTap |
Occurs when a user double taps the grid. |
| LoadMore |
Occurs when a user scrolls to the bottom of the grid to load new data items. |
| LongPress |
Occurs when a user taps and holds anywhere within the grid. |
| PullToRefresh |
Occurs when a user pulls the grid down to refresh its content. |
| SelectionChanged |
Occurs after the selected row has been changed in the grid. |
| Tap |
Occurs when a user taps the grid. |
| TapConfirmed |
Occurs when a single tap is confirmed (a user tapped the grid and a second tap leading to the double-tap gesture did not follow). |
| ValidateCell |
Occurs after a user changes a cell value in the in-place editor and attempts to select another cell. |
| ValidationError |
Occurs when a value in the in-place cell editor fails validation or when it cannot be saved to a data source. |