New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial

All columns in RadGrid that have editing capabilities derive from GridEditableColumn. This class implements the base functionality for editing, using column editors etc.

Provides IGridEditableColumn interface, which RadGrid uses to operate with the state of all the editable columns.

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:

C#
public abstract class GridEditableColumn : GridColumn, IStateManager, IComparable, IGridEditableColumn, IGridDataColumn

Inheritance: objectGridColumnGridEditableColumn

Derived Classes: GridAttachmentColumnGridAutoCompleteColumnGridBinaryImageColumnGridBoundColumnGridCheckBoxColumnGridDropDownColumnGridRatingColumnGridTemplateColumn...

Implements: IComparableIGridDataColumnIGridEditableColumnIStateManager

Inherited Members GridColumn.Initialize()GridColumn.InitializeCell(TableCell, int, GridItem)GridColumn.GetFilterDataField()GridColumn.SupportsFiltering()GridColumn.ShouldSerializeFilterImageUrl()GridColumn.ShouldSerializeSortAscImageUrl()GridColumn.ShouldSerializeSortDescImageUrl()GridColumn.RefreshCurrentFilterValue(GridFilteringItem, string)GridColumn.RefreshCurrentFilterValue(GridFilteringItem)GridColumn.SetCurrentFilterValueToControl(TableCell)GridColumn.GetCurrentFilterValueFromControl(TableCell)GridColumn.EvaluateFilterExpression(GridFilteringItem)GridColumn.EvaluateFilterExpression()GridColumn.FunctionTakesNoArguments(GridKnownFunction)GridColumn.SetupFilterControls(TableCell)GridColumn.GetFilterFunctionsList(GridFilterListOptions, ArrayList)GridColumn.PrepareCell(TableCell, GridItem)GridColumn.LoadViewState(object)GridColumn.OnColumnChanged()GridColumn.SaveViewState()GridColumn.TrackViewState()GridColumn.ResetCurrentFilterValue(GridFilteringItem)GridColumn.ResetCurrentFilterValue()GridColumn.GetDefaultGroupByExpression()GridColumn.IsUniqueName(string)GridColumn.GenerateUniqueNameBase(string)GridColumn.GenerateUniqueName()GridColumn.TrySetOnClientClickScript(Control, GridItem, string, params string[])GridColumn.UpdateUniqueNameIfDefault(string)GridColumn.Clone()GridColumn.IsBoundToFieldName(string)GridColumn.GetCustomPropertyDataFields(object)GridColumn.HeaderTooltipGridColumn.HeaderAbbrGridColumn.HeaderAxisGridColumn.SortedBackColorGridColumn.CurrentFilterValueGridColumn.AndCurrentFilterValueGridColumn.ColumnGroupNameGridColumn.SelectedGridColumn.SelectableGridColumn.CurrentFilterFunctionGridColumn.AndCurrentFilterFunctionGridColumn.FilterDelayGridColumn.ExportableGridColumn.EnableHeaderContextMenuGridColumn.ShowFilterIconGridColumn.FilterListOptionsGridColumn.AutoPostBackOnFilterGridColumn.FilterImageToolTipGridColumn.FilterControlToolTipGridColumn.EditorControlToolTipGridColumn.FilterImageUrlGridColumn.SortAscImageUrlGridColumn.SortDescImageUrlGridColumn.DataTypeNameGridColumn.ListOfFilterValuesGridColumn.FilterTemplateGridColumn.TableViewSpecificStateGridColumn.DesignModeGridColumn.FooterStyleGridColumn.FooterTextGridColumn.HeaderImageUrlGridColumn.HeaderStyleGridColumn.HeaderTextGridColumn.IsTrackingViewStateGridColumn.ItemStyleGridColumn.OwnerGridColumn.SortExpressionGridColumn.GroupByExpressionGridColumn.ViewStateGridColumn.ShowSortIconGridColumn.ShowNoSortIconGridColumn.VisibleGridColumn.DisplayGridColumn.OwnerIDGridColumn.OwnerGridIDGridColumn.ResizableGridColumn.ReorderableGridColumn.GroupableGridColumn.ColumnTypeGridColumn.HeaderButtonTypeGridColumn.OrderIndexGridColumn.IsEditableGridColumn.IsDefaultUniqueNameGridColumn.EditFormColumnIndexGridColumn.UniqueNameGridColumn.EditFormHeaderTextFormatGridColumn.DataTypeGridColumn.FilterControlWidthGridColumn.FilterControlAltTextGridColumn.FilterCheckListWebServiceMethodGridColumn.FilterCheckListEnableLoadOnDemandobject.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()object.GetType()object.MemberwiseClone()...

Constructors

C#
protected GridEditableColumn()

Properties

Gets or sets whether the column data can be filtered.

C#
public virtual bool AllowFiltering { get; set; }
Property Value:

A boolean value, indicating whether the column data can be filtered.

Implements: IGridDataColumn.AllowFiltering

Gets or sets a whether the column data can be sorted.

C#
public virtual bool AllowSorting { get; set; }
Property Value:

A boolean value, indicating whether the column data can be sorted.

Implements: IGridDataColumn.AllowSorting

Gets the column editor instance for this column.

C#
[Browsable(false)]
public virtual IGridColumnEditor ColumnEditor { get; set; }
Property Value:

The column editor instance for this column.

Implements: IGridEditableColumn.ColumnEditor

Gets or sets the column editor ID that will be used when the column is displayed in edit mode.

C#
public string ColumnEditorID { get; set; }
Property Value:

The column editor ID that will be used when the column is displayed in edit mode.

Convert the emty string to null when extracting values for inserting, updating, deleting

C#
public bool ConvertEmptyStringToNull { get; set; }

Get the current colum editor. If the column editor is not assigned at the moment the column will search for the ColumnEditorID on the page or should create its default column editor

C#
[SuppressMessage("Microsoft.Performance", "CA1800:DoNotCastUnnecessarily")]
[Browsable(false)]
public virtual IGridColumnEditor CurrentColumnEditor { get; }

Gets or sets a default value for the column when the row is in Insert mode

C#
public string DefaultInsertValue { get; set; }

Force RadGrid to extract values from EditableColumns that are ReadOnly (or IsEditable is false).

C#
public GridForceExtractValues ForceExtractValue { get; set; }

Implements: IGridEditableColumn.ForceExtractValue

C#
protected IGridColumnEditor InnerColumnEditor { get; }

Gets or sets a value determining whether a editor will be displayed in the insert item. Inherited: The visibility is dependent on the value of the ReadOnly property. AlwaysVisible: The insert item is always visible AlwaysHidden: The insert item is always hidden

C#
public GridColumnVisibilityMode InsertVisiblityMode { get; set; }
C#
public IGridColumnEditor MobileEditor { get; set; }

Gets or sets the readonly status of the column. The column will be displayed in browser mode (unless its Visible property is false) but will not appear in the edit-form.

C#
[SuppressMessage("Microsoft.Naming", "CA1716:IdentifiersShouldNotMatchKeywords", MessageId = "ReadOnly")]
public virtual bool ReadOnly { get; set; }
Property Value:

A boolean value, indicating whether a column is ReadOnly.

Should override if sorting will be disabled

C#
protected override bool Sortable { get; }

Overrides: GridColumn.Sortable

Gets or sets whether the column editor will be native when gird's RenderMode is set to Mobile

C#
public bool UseNativeEditorsInMobileMode { get; set; }

Methods

C#
protected virtual void ColumnEditorChange(IGridColumnEditor newValue)
Parameters:newValueIGridColumnEditor
C#
protected virtual object ConvertValueIfEmpty(string value)
Parameters:valuestringReturns:

object

C#
protected override void CopyBaseProperties(GridColumn fromColumn)
Parameters:fromColumnGridColumn

Overrides: GridColumn.CopyBaseProperties(GridColumn)

C#
protected virtual IGridColumnEditor CreateDefaultColumnEditor()
Returns:

IGridColumnEditor

Extracts the values from the editedItem and fills the names/values pairs for each data-field edited by the column in the newValues dictionary.

C#
public abstract void FillValues(IDictionary newValues, GridEditableItem editableItem)
Parameters:newValuesIDictionary

dictionary to fill. This param should not be null (Nothing in VB.NET)

editableItemGridEditableItem

the GridEditableItem to extract values from

Implements: IGridEditableColumn.FillValues(IDictionary, GridEditableItem)

Returns the DataField that will be used for Filter and Sorting operations

C#
public virtual string GetActiveDataField()
Returns:

string

Implements: IGridDataColumn.GetActiveDataField()

C#
protected virtual GridEditableColumn GetEditableColumn()
Returns:

GridEditableColumn

C#
protected void SetDefaultColumnEditor(IGridColumnEditor defaultEditor)
Parameters:defaultEditorIGridColumnEditor

Get value based on the current IsEditable state, item edited state and ForceExtractValue setting.

C#
public virtual bool ShouldExtractValues(GridEditableItem item)
Parameters:itemGridEditableItem

item to check to extract values from

Returns:

bool

Implements: IGridEditableColumn.ShouldExtractValues(GridEditableItem)