Click or drag to resize
GridTableView Class
Grid table
Inheritance Hierarchy
SystemObject
  System.Web.UIControl
    System.Web.UI.WebControlsWebControl
      System.Web.UI.WebControlsBaseDataBoundControl
        System.Web.UI.WebControlsDataBoundControl
          System.Web.UI.WebControlsCompositeDataBoundControl
            Kettic.AspNet.ControlsGridTableViewBase
              Kettic.AspNet.ControlsGridTableView

Namespace: Kettic.AspNet.Controls
Assembly: Kettic.AspNet.Controls (in Kettic.AspNet.Controls.dll) Version: 2014.4.1129.0 (2014.04.1129.0)
Syntax
public class GridTableView : GridTableViewBase, 
	INamingContainer

The GridTableView type exposes the following members.

Constructors
  NameDescription
Public methodGridTableView
Default contructor for GridTableView - generally used by Page serializer only.
Public methodGridTableView(KaxGrid)
Constructs a new GridTableView and sets as its owner the KaxGrid object.
Public methodGridTableView(KaxGrid, Boolean)
Constructs a new GridTableView and sets as its owner the KaxGrid object. Sets the IsTrackingViewState property to the corresponding value of the boolean parameter.
Top
Methods
  NameDescription
Public methodClearEditItems
Removes all edit items that belong to the GridTableView instance.
Public methodClearSelectedItems
Removes all selected items that belong to this GridTableView instance.
Public methodDataBind
Binds the data source to the KaxGrid instance.
(Overrides BaseDataBoundControlDataBind.)
Public methodExportToCSV
Exports the grid data in CSV format using the properties set in the ExportSettings.
Public methodExportToExcel
Exports the grid data in Microsoft Excel � format using the properties set in the ExportSettings.
Public methodExportToPdf
Exports the grid data in PDF format using the properties set in the ExportSettings.
Public methodExportToWord
Exports the grid data in Microsoft Word � format based on the selected ExportSettings.
Public methodExtractValuesFromItem
The passed IDictionary object (like Hashtable for example) will be filled with the names/values of the corresponding column data-fields and their values. Only instances of type GridEditableColumn support extracting values.
Public methodFindItemByKeyValue
Public methodFindItemsByKeyValues
Public methodGetColumn
Returns a GridColumn based on its UniqueName.
Public methodGetColumnSafe
Returns a GridColumn based on its UniqueName.
Public methodGetInsertItem
Get the item that appears when grid is in Insert Mode.
Public methodGetItems
Returns a collection of GridItem objects based on their ItemType.
Public methodGetSelectedItems
Public methodHasAggregates
Public methodInsertItem
Places the GridTableView in insert mode, allowing user to insert a new data-item values. The CurrentPageIndex will be set to display the last page. You can use also the IsItemInserted to place the GridTableView in insert mode.
Public methodInsertItem(IDictionary)
Places the GridTableView in insert mode, allowing the user to insert a new data-item values. The GridInsertItem created will be bound to values found in newValues dictionary; The CurrentPageIndex will be set to display the last page. You can use also the IsItemInserted to place the GridTableView in insert mode.
Public methodInsertItem(Object)
Places the GridTableView in insert mode, allowing the user to insert a new data-item values. The GridInsertItem created will be bound to values of the newDataItem object. The CurrentPageIndex will be set to display the last page. You can use also the IsItemInserted property to place the GridTableView in insert mode.
Public methodPerformDelete(GridEditableItem)
Perform asynchronous delete operation, using the DataSourceControl API the Rebinds the grid. Please make sure you have specified the correct DataKeyNames for the GridTableView. When the asynchronous operation calls back, KaxGrid will fire ItemDeleted event.
Public methodPerformDelete(GridEditableItem, Boolean)
Perform delete operation, using the DataSourceControl API. Please make sure you have specified the correct DataKeyNames for the GridTableView.
Public methodPerformInsert
Perform asynchronous insert of the new item, diplayed by KaxGrid when in edit mode, using the DataSourceControl API, then Rebind. When the asynchronous operation calls back, KaxGrid will fire ItemInserted event.
Public methodPerformInsert(GridEditableItem)
Performs asynchronous insert operation, using the DataSourceControl API, then Rebinds. When the asynchronous operation calls back, KaxGrid will fire ItemInserted event.
Public methodPerformInsert(GridEditableItem, Boolean)
Perform asynchronous insert operation, using the DataSource control API. When the asynchronous operation calls back, KaxGrid will fire ItemInserted event.
Public methodPerformUpdate(GridEditableItem)
Perform asynchronous update operation, using the DataSource control API and the Rebind method. Please, make sure you have specified the correct DataKeyNames for the GridTableView. When the asynchronous operation calls back, KaxGrid will fire ItemUpdated event.
Public methodPerformUpdate(GridEditableItem, Boolean)
Perform asynchronous update operation, using the DataSource control API. Please make sure you have specified the correct DataKeyNames for the GridTableView. When the asynchronous operation calls back, KaxGrid will fire ItemUpdated event. The boolean property defines if KaxGrid will Rebind after the update.
Public methodRebind
Public methodSwapColumns(Int32, Int32)
Swaps columns appearance position using order indexes of the two columns.
Public methodSwapColumns(String, String)
Swaps columns appearance position using the unique names of the two columns.
Public methodSwapColumns(GridColumn, GridColumn)
Top
Properties
  NameDescription
Public propertyAdditionalDataFieldNames
Gets or sets values indicating DataFieldNames that should be sorted, grouped, etc and are not included as columns, in case the property RetrieveAllDataFields is false.
Public propertyAllowAutomaticDeletes
Gets or sets a value indicating whether Kettic KaxGrid will perform automatic deletes, i.e. using the DataSource controls functionality.
Public propertyAllowAutomaticInserts
Gets or sets a value indicating whether Kettic KaxGrid will perform automatic inserts, i.e. using the DataSource controls functionality.
Public propertyAllowAutomaticUpdates
Gets or sets a value indicating whether Kettic KaxGrid will perform automatic updates, i.e. using the DataSource controls functionality.
Public propertyAllowCustomPaging
Gets or sets if the custom paging feature is enabled.
Public propertyAllowCustomSorting
Gets or sets if the custom sorting feature is enabled.
Public propertyAllowFilteringByColumn

Gets or sets a value indicating whether the filtering by column feature is enabled.

Public propertyAllowMultiColumnSorting
Gets or sets the value indicating wheather more than one column can be sorted in a single GridTableView. The order is the same as the sequence of expressions in SortExpressions.
Public propertyAllowNaturalSort
Gets or sets the value indicated whether the no-sort state when changing sort order will be allowed.
Public propertyAllowPaging

Gets or sets a value indicating whether the paging feature is enabled.

Public propertyAllowSorting

Gets or sets a value indicating whether the sorting feature is enabled.

Public propertyAlternatingItemStyle

Gets a reference to the GridTableItemStyle object that allows you to set the appearance of alternating items in a GridTableView control.

Public propertyAutoGenerateColumns
Gets or sets a value indicating whether Kettic KaxGrid will automatically generate columns at runtime based on its DataSource.
Public propertyAutoGeneratedColumns
Get an array of automatically generated columns. This array is available when AutoGenerateColumns is set to true. Autogenerated columns appear always after Columns when rendering.
Public propertyCanRetrieveAllData

Gets or sets a value indicating whether Kettic KaxGrid should retrieve all data and ignore server paging in case of filtering or grouping.

Public propertyCaption

Gets or sets a string that specifies a brief description of a GridTableView. Related to Kettic KaxGrid accessibility compliance.

Public propertyChildEditItems

Gets all items among the hierarchy of GridTableView items that are in edit mode. The edit items in a GridTableView are cleared when ParentItem collapses.

Public propertyChildSelectedItems

Gets all items among the hierarchy of GridTableView items that are selected. The selected items in a GridTableView are cleared when ParentItem collapses and the ParentItem becomes selected.

Public propertyClientDataKeyNames
Public propertyClientID (Overrides ControlClientID.)
Public propertyColumns

Gets a collection of GridColumn objects that represent the column fields in a GridTableView control.

Public propertyCommandItemDisplay

Gets or sets the default position of the GridCommandItem as defined by the GridCommandItemDisplay. The possible values are:

  • None - this is the default value - the command item will not be rendered
  • Top - the command item will be rendered on the top of the grid
  • Bottom - the command item will be rendered on the bottom of the grid
  • TopAndBottom - the command item will be rendered both on top and bottom of the grid.
Public propertyCommandItemSettings
Gets a set the options for GridTableView's command item.
Public propertyCommandItemStyle
Gets a referenct to the GridTableItemStyle object that allows you to set the appearance of the command item in a GridTableView control.
Public propertyCommandItemTemplate

Gets or sets the template that will be instantiated in the CommandItem. If this template is set, KaxGrid will not create the default CommandItem controls.

Public propertyCurrentPageIndex
Gets or sets a value indicating the index of the currently active page in case paging is enabled (AllowPaging is true).
Public propertyCurrentResetPageIndexAction

Gets or sets a value that describes how KaxGrid would respond if the CurrentPageIndex is invalid when data-binding.

Public propertyDataKeyNames

Gets or sets an array of data-field names that will be used to populate the DataKeyValues collection, when the GridTableView control is databinding.

Public propertyDataKeyValues
Gets a collection of DataKeyValue objects that represent the data key value of the corresponding item (specified with its ItemIndex) and the DataKeyName (case-sensitive!). The DataKeyName should be one of the specified in the DataKeyNames array.
Public propertyDataSource

Gets or sets the object from which the data-bound control retrieves its list of data items.

(Overrides BaseDataBoundControlDataSource.)
Public propertyDataSourceCount
Gets the number of pages if paging is enabled.
Public propertyDataSourceID
Gets or sets the data source id in KaxGrid.
(Overrides DataBoundControlDataSourceID.)
Public propertyDetailTables

Gets or sets the collection of detail table views for this GridTableView

Public propertyDir

Gets or sets the text direction. This property is related to Kettic KaxGrid support for Right-To-Left lanugages. It has two possible vales defined by GridTableTextDirection enumeration:

  • LTR - left-to-right text
  • RTL - right-to-left text
Public propertyEditFormSettings
Gets a value defining the setting that will be applied when an Item is in edit mode and the EditMode property is set to EditForms.
Public propertyEditItemStyle

Gets a reference to the GridTableItemStyle object that allows you to set the appearance of the item selected for editing in a GridTableView control.

Public propertyEditItemTemplate
Gets or sets the EditItemTemplate, which is rendered in the control in edit mode.
Public propertyEditMode

FormsGets or sets a value indicating how a GridItem will look in edit mode.

Public propertyEnableColumnsViewState
Gets or sets a value indicating whether all columns settings will be persisted in the ViewState or not.
Public propertyEnableHeaderContextFilterMenu

Gets or sets a value indicating whether the header context filter menu should be enabled.

Public propertyEnableHeaderContextMenu

Gets or sets a value indicating whether the header context menu should be enabled.

Public propertyEnableNoRecordsTemplate
Gets or sets a value indicating whether KaxGrid will show NoRecordsTemplate instead of the corresponding GridTableView if there is no items to display.
Public propertyExpandCollapseColumn
Gets a reference to the ExpandCollapseColumn object, allowing you to customize its settings.
Public propertyFilterExpression

Gets or sets the filtering options for grid columns.

Public propertyFilterItemStyle
Gets a reference to the GridTableItemStyle object that allows you to set the appearance of the filter item in a GridTableView control.
Public propertyFooterStyle
Manage visual style of the footer item.
Public propertyFrame
Gets or sets a value specifying the frame table attribute.
Public propertyGridLines
Gets or sets an enumeration value, indicating the appearance of the data table border between cells.
(Overrides GridTableViewBaseGridLines.)
Public propertyGroupByExpressions
Adding GridGroupByExpression to this collection will cause the current table-view to display items sorted and devided in groups separated by GridGroupHeaderItems, that display common group and aggregate field values. See Expression on details of expressions syntax.
Public propertyGroupHeaderItemStyle
Manage visual style of the group header items.
Public propertyGroupLoadMode

Specifies where the grouping will be handled. There are two options:

  • Server-side - GridTableView.GroupLoadMode.Server
  • Client-side - GridTableView.GroupLoadMode.Client
Public propertyGroupsDefaultExpanded
Gets or sets a value indicating whether the groups will be expanded on grid load (true by default).
Public propertyHasDetailTables
Gets a value indicating if the GridTableView instance has children (Detail) tables.
Public propertyHeaderStyle

Gets a reference to the GridTableItemStyle object that allows you to set the appearance of the header item in a GridTableView control.

Public propertyHierarchyDefaultExpanded
Gets or sets a value indicating whether the hierarchy will be expanded by default. The default value of the property is false.
Public propertyHierarchyIndex
The unique hierarchy index of the current table view, generated when it is binding.
Public propertyHierarchyLoadMode

Gets or sets a value indicating when the DataBind of the child GridTableView will occur when working in hierarchy mode. Accepts values from GridChildLoadMode enumeration. See the remars for details.

Public propertyHorizontalAlign
Gets or sets horizontal alignment style in the data table.
(Overrides GridTableViewBaseHorizontalAlign.)
Public propertyID
Gets or sets the programmatic identifier assigned to the current GridTableView.
(Overrides ControlID.)
Public propertyInsertItemDisplay
Public propertyInsertItemPageIndexAction
Public propertyIsFilterItemExpanded
Public propertyIsItemInserted
Gets or sets a value indicating if the GridTableView is currently in insert mode.
Public propertyItems

Gets a collection of GridDataItem objects that represent the data items in a GridDataItem control.

Public propertyItemsCreated
Indicates whether the items have been created, generally by data-binding.
Public propertyItemsHierarchy

Gets a collection of all data items of a grid table view and items that belong to child tables of the GridTableView if the hierarchy is expanded. The items are collected depth-first. The property Items actually referres to ItemsHierarchy of
MainView. This property can be used to traverse all
DataItems items in the hiearchy of a GridTableView.

Public propertyItemStyle

Gets a reference to the GridTableItemStyle object that allows you to set the appearance of items in a GridTableView control.

Public propertyItemTemplate
Gets or sets the ItemTemplate, which is rendered in the control in normal (non-Edit) mode.
Public propertyName
Gets or sets the name of the GridTableView.
Public propertyNestedViewSettings
Gets a set of options for the GridTableView's data-bound nested view template.
Public propertyNestedViewTemplate
Gets or sets the ItemTemplate, which is rendered in the control in normal (non-Edit) mode.
Public propertyNoDetailRecordsText
Gets or sets the text that will be displayed in there is no NoRecordsTemplate defined and no records in the Detail tables.
Public propertyNoMasterRecordsText
Gets or sets the text that will be displayed in there is no NoRecordsTemplate defined and no records in the MainView.
Public propertyNoRecordsTemplate

Gets or sets the template that will be displayed if a GridTableView control is bound to a data source that does not contain any records.

Public propertyOverrideDataSourceControlSorting
Gets or sets a value indicating if the GridTableView should override the default DataSourceControl sorting with grid native sorting.
Public propertyOwnerID
Gets the ClientID of the KaxGrid object that contains this instance.
Public propertyPageCount

Gets the number of pages required to display the records of the data source in a GridTableView control.

Public propertyPagerStyle
Gets a reference to the GridPagerStyle object that allows you to set the appearance of the pager item in a GridTableView control.
Public propertyPagerTemplate

Gets or sets the custom content for the pager item in a GridTableView control.

Public propertyPageSize

Specify the maximum number of items that would appear in a page, when paging is enabled by AllowPaging or AllowCustomPaging property. Default value is the value of PageSize.

Public propertyPagingManager
Gets a Paging object that is the result of paging settings and runtime paging state of the grid.
Public propertyParentItem
Gets a reference to a GridItem that is a parent of this GridTableView, when this GridTableView represents a child table in a hierarchical structure.
Public propertyParentTableRelation
Gets or sets the collection of data-field pairs that describe the relations in a hierarchical grid.
Public propertyRenderActiveItemStyle
Gets the rendering style of an ActiveItem.
Public propertyRenderAlternatingItemStyle
Gets the rendering style of the AlternatingItem.
Public propertyRenderColumns
Gets an array of all columns that are used when rendering the grid instance.
Public propertyRenderCommandItemStyle
Gets the rendering style of a CommandItem.
Public propertyRenderEditItemStyle
Gets the rendering style of an edit Item.
Public propertyRenderFilterItemStyle
Gets the rendering style of a FilterItem.
Public propertyRenderFooterStyle
Gets the rendering style of an FooterItem.
Public propertyRenderGroupHeaderItemStyle
Gets the rendering style of the group header items.
Public propertyRenderHeaderStyle
Gets the rendering style of a GridHeaderItem.
Public propertyRenderItemStyle
Gets the rendering style of an Item.
Public propertyRenderPagerStyle
Gets the rendering style of the Pager item.
Public propertyRequiresBinding
Gets or sets a value indicating whether KaxGrid will be built on PreRender unless it was built before that. This property is supposed for Kettic KaxGrid internal usage, yet you can set it with care.
Public propertyResolvedDataSourceView
Gets a DataView object that represents the data sent to the GridTableView to be displayed.
Public propertyRetrieveAllDataFields

Gets or sets a value indicating whether the GridTableView will extract all bindable properties from the DataSource when binding, to perform operations like sorting, grouping, etc on DataFields that are not included in the column declarations.

Public propertyRetrieveDataTypeFromFirstItem
Gets or sets a value indicating whether items' data type should be retrieved from supplied enumerable's first item.
Public propertyRetrieveNullAsDBNull

Gets or sets a value indicating whether null values in the database will be retrieved as dbnull values.

Public propertyRowIndicatorColumn
Gets a reference to the RowIndicatorColumn object, allowing you to customize its settings.
Public propertySelectedItemStyle
Gets a reference to the Style object that allows you to set the appearance of the selected item in a GridTableView control.
Public propertySelfHierarchySettings
Gets a set the options for GridTableView's self-hierarchy behavior.
Public propertyShowFooter
Gets or sets a value indicating if the GridFooterItem will be shown in the current GridTableView.
Public propertyShowGroupFooter
Gets or sets a value indicating if the GridGroupFooterItem will be shown in the current GridTableView.
Public propertyShowHeader
Gets or sets a value indicating if the GridHeaderItem will be shown in the current GridTableView.
Public propertyShowHeadersWhenNoRecords
If set to true (the default) GridNoRecordsItem is used to display no records template. This item is the only one displayed in the GridTableView in this case.
Public propertySortExpressions
Gets a collection of sort expressions for this table view instance, associated with the column or columns being sorted.
Public propertySummary
Gets or sets the 'summary' attribute for the respective table.
Public propertyTableLayout
Gets or sets a string that indicates whether the table layout is fixed.
Public propertyUseAllDataFields

Gets or sets a value indicating whether the GridTableView should use all retieved properties from the DataSource when binding, to perform operations like sorting, grouping, etc on DataFields that are not included in the column declarations.

Public propertyVirtualItemCount
Top
See Also