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

GridEditableItem

Class

Represents the base class for any items that display and edit data in a GridTableView of RadGrid. Inheritors has the capabilities to:

Locate a table cell based on the column unique names
Extract values from the cells of column editors
Has a dictionary of saved-old-values that are necessary for optimistic concurency editing oprations
Edit/browse mode
EditManager instance, which is capable of locating the column editors

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:

public abstract class GridEditableItem : GridItem, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, INamingContainer

Inheritance: objectControlWebControlTableRowGridTableRowGridItemGridEditableItem...

Derived Classes: GridDataItemGridEditFormItem

Implements: IAttributeAccessorIComponentIControlBuilderAccessorIControlDesignerAccessorIDataBindingsAccessorIDisposableIExpressionsAccessorINamingContainerIParserAccessorIUrlResolutionService...

Inherited Members GridItem.AddAttributesToRender(HtmlTextWriter)GridItem.FireCommandEvent(string, object)GridItem.OnBubbleEvent(object, EventArgs)GridItem.SetItemType(GridItemType)GridItem.OnCellDataBound(GridColumn, TableCell)GridItem.CellsDataBound(GridColumn[])GridItem.CreateCellObject()GridItem.CreateCellObject(GridColumn)GridItem.RemoveSelectedChildren()GridItem.RemoveEditedChildren()GridItem.GetExpandedDefaultValue()GridItem.OnExpand()GridItem.OnCollapse()GridItem.ExpandHierarchyToTop()GridItem.SetEdited(bool)GridItem.CalcColSpan(GridColumn[], int, int)GridItem.LoadViewState(object)GridItem.LeftAlign()GridItem.RightAlign()GridItem.OwnerTableViewGridItem.OwnerIDGridItem.OwnerGridIDGridItem.HasChildItemsGridItem.CanExpandGridItem.DataItemGridItem.DataSetIndexGridItem.ItemIndexGridItem.ItemIndexHierarchicalGridItem.ItemTypeGridItem.ExpandedGridItem.DisplayGridItem.SelectedGridItem.SelectableModeGridItem.EditGridItem.GroupIndexGridItem.IsDataBoundGridItem.IsInEditModeGridTableRow.OriginalClientIDGridTableRow.ClientIDTableRow.CreateControlStyle()TableRow.CreateControlCollection()TableRow.CellsTableRow.HorizontalAlignTableRow.SupportsDisabledAttributeTableRow.TableSectionTableRow.VerticalAlignWebControl.ApplyStyle(Style)WebControl.CopyBaseAttributes(WebControl)WebControl.TrackViewState()WebControl.MergeStyle(Style)WebControl.Render(HtmlTextWriter)WebControl.RenderBeginTag(HtmlTextWriter)WebControl.RenderEndTag(HtmlTextWriter)WebControl.RenderContents(HtmlTextWriter)WebControl.SaveViewState()WebControl.AccessKeyWebControl.AttributesWebControl.BackColorWebControl.BorderColorWebControl.BorderWidthWebControl.BorderStyleWebControl.ControlStyleWebControl.ControlStyleCreatedWebControl.CssClassWebControl.DisabledCssClassWebControl.StyleWebControl.EnabledWebControl.EnableThemingWebControl.FontWebControl.ForeColorWebControl.HasAttributesWebControl.HeightWebControl.IsEnabledWebControl.SkinIDWebControl.TabIndexWebControl.TagKeyWebControl.TagNameWebControl.ToolTipWebControl.WidthControl.ResolveAdapter()Control.HasEvents()Control.GetRouteUrl(object)Control.GetRouteUrl(string, object)Control.GetRouteUrl(RouteValueDictionary)Control.GetRouteUrl(string, RouteValueDictionary)Control.GetUniqueIDRelativeTo(Control)Control.ApplyStyleSheetSkin(Page)Control.OnDataBinding(EventArgs)Control.DataBind()Control.DataBind(bool)Control.DataBindChildren()Control.AddParsedSubObject(object)Control.EnsureID()Control.OnInit(EventArgs)Control.ClearChildState()Control.ClearChildControlState()Control.ClearChildViewState()Control.ClearEffectiveClientIDMode()Control.ClearCachedClientID()Control.Focus()Control.LoadControlState(object)Control.MapPathSecure(string)Control.OpenFile(string)Control.OnLoad(EventArgs)Control.OnPreRender(EventArgs)Control.BuildProfileTree(string, bool)Control.SaveControlState()Control.RenderChildren(HtmlTextWriter)Control.RenderControl(HtmlTextWriter)Control.RenderControl(HtmlTextWriter, ControlAdapter)Control.OnUnload(EventArgs)Control.Dispose()Control.RaiseBubbleEvent(object, EventArgs)Control.AddedControl(Control, int)Control.CreateChildControls()Control.ResolveUrl(string)Control.ResolveClientUrl(string)Control.FindControl(string)Control.FindControl(string, int)Control.GetDesignModeState()Control.HasControls()Control.IsLiteralContent()Control.EnsureChildControls()Control.RemovedControl(Control)Control.SetDesignModeState(IDictionary)Control.SetRenderMethodDelegate(RenderMethod)Control.ClientIDModeControl.ClientIDSeparatorControl.ContextControl.AdapterControl.DesignModeControl.EventsControl.IDControl.IsChildControlStateClearedControl.EnableViewStateControl.ViewStateModeControl.IsViewStateEnabledControl.NamingContainerControl.IdSeparatorControl.LoadViewStateByIDControl.PageControl.RenderingCompatibilityControl.TemplateControlControl.ParentControl.TemplateSourceDirectoryControl.AppRelativeTemplateSourceDirectoryControl.SiteControl.VisibleControl.UniqueIDControl.HasChildViewStateControl.ControlsControl.ValidateRequestModeControl.ViewStateControl.ViewStateIgnoresCaseControl.ChildControlsCreatedControl.IsTrackingViewStateControl.DisposedControl.DataBindingControl.InitControl.LoadControl.PreRenderControl.Unloadobject.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()object.GetType()object.MemberwiseClone()...

Constructors

GridEditableItem(GridTableView, int, int, GridItemType)

public GridEditableItem(GridTableView ownerTableView, int itemIndex, int dataSetIndex, GridItemType itemType)

Parameters:ownerTableViewGridTableViewitemIndexintdataSetIndexintitemTypeGridItemType

GridEditableItem(GridTableView, int, int)

public GridEditableItem(GridTableView ownerTableView, int itemIndex, int dataSetIndex)

Parameters:ownerTableViewGridTableViewitemIndexintdataSetIndexint

Properties

EditManager

GridEditManager

Allows you to access the column editors

public virtual GridEditManager EditManager { get; }

Example:

cs-api-definition
GridEditManager editMan = editedItem.EditManager;
IGridEditableColumn editableCol = (column as IGridEditableColumn);
IGridColumnEditor editor = editMan.GetColumnEditor( editableCol );
cs-api-definition.skip-repl
Dim editMan As GridEditManager = editedItem.EditManager
Dim editableCol As IGridEditableColumn = CType(column, IGridEditableColumn)
Dim editor As IGridColumnEditor = editMan.GetColumnEditor(editableCol)

KeyValues

string

public string KeyValues { get; }

Example:

cs-api-definition
string keyValues = ((GridEditableItem)e.Item).KeyValues;
if (keyValues.Contains("CustomerID"))
Session["CustomerID"] = keyValues.Substring(13, keyValues.Length - 1);
else
Session["OrderID"] = keyValues.Substring(10, keyValues.Length - 1);
cs-api-definition.skip-repl
Dim keyValues As String = CType(e.Item, GridEditableItem).KeyValues
If keyValues.Contains("CustomerID") Then
Session("CustomerID") = keyValues.Substring(13, keyValues.Length - 1)
Else
Session("OrderID") = keyValues.Substring(10, keyValues.Length - 1)
End If

SavedOldValues

IDictionary

Gets the old value of the edited item

public abstract IDictionary SavedOldValues { get; }

Example:

cs-api-definition
foreach (DictionaryEntry entry in newValues)
{
Label1.Text += "\n&lt;br /&gt;Key: " + entry.Key + "&lt;br /&gt;New value: " + entry.Value + "&lt;br /&gt; Old value: " + editedItem.SavedOldValues[entry.Key] + "&lt;br /&gt;";
}
cs-api-definition.skip-repl
cs-api-definition.skip-repl
For Each entry As DictionaryEntry In newValues
Label1.Text += "" &amp; Microsoft.VisualBasic.Chr(10) &amp; "&lt;br /&gt;Key: " + entry.Key + "&lt;br /&gt;New value: " + entry.Value + "&lt;br /&gt; Old value: " + editedItem.SavedOldValues(entry.Key) + "&lt;br /&gt;"
Next

Methods

ExtractValues(IDictionary)

Extracts values for each column, using FillValues(IDictionary, GridEditableItem)

public virtual void ExtractValues(IDictionary newValues)

Parameters:newValuesIDictionary

This dictionary to fill, this parameter should not be null

GetDataKeyValue(string)

Get the DataKeyValues from the owner GridTableView with the corresponding item ItemIndex and keyName. The keyName should be one of the specified in the DataKeyNames array

public virtual object GetDataKeyValue(string keyName)

Parameters:keyNamestring

data key name

Returns:

object

data key value

UpdateValues(object)

Extracts values for each column, using FillValues(IDictionary, GridEditableItem) and updates values in provided object;

[SuppressMessage("Microsoft.Performance", "CA1800:DoNotCastUnnecessarily")]
public virtual void UpdateValues(object objectToUpdate)

Parameters:objectToUpdateobject

The object that should be updated