skip navigation
  • Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • AI Coding Assistants
    • Embedded Reporting
    • Document Processing Libraries
    • SSO Account Sign-in

    Web

    Kendo UI UI for Angular UI for Vue UI for jQuery KendoReact UI for Blazor UI for ASP.NET Core UI for ASP.NET MVC UI for ASP.NET AJAX

    Mobile

    UI for .NET MAUI

    Document Management

    Telerik Document Processing

    Desktop

    UI for .NET MAUI UI for WinUI UI for WinForms UI for WPF

    Reporting

    Telerik Reporting Telerik Report Server

    Testing & Mocking

    Test Studio Telerik JustMock

    CMS

    Sitefinity

    AI Productivity Tools

    AI Coding Assistants

    UI/UX Tools

    ThemeBuilder Design System Kit Templates and Building Blocks

    Debugging

    Fiddler Fiddler Everywhere Fiddler Classic Fiddler Everywhere Reporter FiddlerCore

    Free Tools

    KendoReact Free VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Roadmap
    • Release History
  • Support and Learning

    • Support and Learning Hub
    • First Steps
    • Docs
    • Demos
    • Virtual Classroom
    • Forums
    • Videos
    • Blogs
    • Accessibility
    • Submit a Ticket

    Productivity and Design Tools

    • Visual Studio Extensions
    • Visual Studio Templates
    • Embedded Reporting
  • Pricing
  • Shopping cart
    • Account Overview
    • Your Licenses
    • Downloads
    • Support Center
    • Forum Profile
    • Payment Methods
    • Edit Profile
    • Log out
  • Login
  • Contact Us
  • Try now

Class GridViewDataColumn

GridViewDataColumn inherits GridViewColumn and is base for all data-bound columns.

Inheritance
System.Object
DisposableObject
RadObject
GridViewColumn
GridViewDataColumn
GridViewBrowseColumn
GridViewCalculatorColumn
GridViewCheckBoxColumn
GridViewColorColumn
GridViewComboBoxColumn
GridViewCommandColumn
GridViewDateTimeColumn
GridViewDecimalColumn
GridViewHyperlinkColumn
GridViewImageColumn
GridViewMaskBoxColumn
GridViewRatingColumn
GridViewSparklineColumn
GridViewTextBoxColumn
GridViewTimeSpanColumn
Inherited Members
GridViewColumn.FieldNameProperty
GridViewColumn.NameProperty
GridViewColumn.HeaderTextProperty
GridViewColumn.ExpressionProperty
GridViewColumn.EnableExpressionEditorProperty
GridViewColumn.IsVisibleProperty
GridViewColumn.IsAutoGeneratedProperty
GridViewColumn.VisibleInColumnChooserProperty
GridViewColumn.PinPositionProperty
GridViewColumn.AllowSortProperty
GridViewColumn.AllowGroupProperty
GridViewColumn.ReadOnlyProperty
GridViewColumn.AllowResizeProperty
GridViewColumn.AllowHideProperty
GridViewColumn.DisableHTMLRenderingProperty
GridViewColumn.WrapTextProperty
GridViewColumn.TextAlignmentProperty
GridViewColumn.HeaderTextAlignmentProperty
GridViewColumn.HeaderImageProperty
GridViewColumn.HeaderSvgImageProperty
GridViewColumn.ImageLayoutProperty
GridViewColumn.TextImageRelationProperty
GridViewColumn.WidthProperty
GridViewColumn.RenderWidthProperty
GridViewColumn.MinWidthProperty
GridViewColumn.MaxWidthProperty
GridViewColumn.RowSpanProperty
GridViewColumn.StretchVerticallyProperty
GridViewColumn.ShowEditorProperty
GridViewColumn.IsCurrentProperty
GridViewColumn.AutoEllipsisProperty
GridViewColumn.AutoSizeModeProperty
GridViewColumn.AllowReorderProperty
GridViewColumn.TagProperty
GridViewColumn.BestFit()
GridViewColumn.Sort(RadSortOrder, Boolean)
GridViewColumn.GetDefaultGroupByExpression()
GridViewColumn.CanDragToGroup(GridViewTemplate)
GridViewColumn.CanDragToGroup()
GridViewColumn.GetDefaultMinWidth()
GridViewColumn.IsPropertyCancelable(RadPropertyMetadata)
GridViewColumn.GetDefaultEditor()
GridViewColumn.GetDefaultEditorType()
GridViewColumn.InitializeEditor(IInputEditor)
GridViewColumn.DispatchEvent(KnownEvents, GridEventType, GridEventDispatchMode, Object, Object[])
GridViewColumn.OnNotifyPropertyChanging(String)
GridViewColumn.OnPropertyChanging(RadPropertyChangingEventArgs)
GridViewColumn.IsFieldNamePath
GridViewColumn.HeaderImage
GridViewColumn.HeaderSvgImage
GridViewColumn.ImageLayout
GridViewColumn.TextImageRelation
GridViewColumn.Width
GridViewColumn.MinWidth
GridViewColumn.MaxWidth
GridViewColumn.RowSpan
GridViewColumn.StretchVertically
GridViewColumn.AutoSizeMode
GridViewColumn.Tag
GridViewColumn.FieldName
GridViewColumn.Name
GridViewColumn.SortOrder
GridViewColumn.Expression
GridViewColumn.EnableExpressionEditor
GridViewColumn.ConditionalFormattingObjectList
GridViewColumn.Index
GridViewColumn.OwnerTemplate
GridViewColumn.IsDataBound
GridViewColumn.IsAutoGenerated
GridViewColumn.IsSorted
GridViewColumn.IsGrouped
GridViewColumn.VisibleInColumnChooser
GridViewColumn.IsVisible
GridViewColumn.IsCurrent
GridViewColumn.IsPinned
GridViewColumn.PinPosition
GridViewColumn.AllowReorder
GridViewColumn.AllowSort
GridViewColumn.AllowGroup
GridViewColumn.ReadOnly
GridViewColumn.AllowResize
GridViewColumn.AllowHide
GridViewColumn.HeaderText
GridViewColumn.DisableHTMLRendering
GridViewColumn.WrapText
GridViewColumn.AutoEllipsis
GridViewColumn.HeaderTextAlignment
GridViewColumn.TextAlignment
GridViewColumn.EventDispatcher
GridViewColumn.DpiScale
GridViewColumn.PropertyChanging
RadObject.BindingContextProperty
RadObject.RadType
RadObject.ReplaceDefaultDescriptors(PropertyDescriptorCollection)
RadObject.DisposeManagedResources()
RadObject.ClearPropertyStore()
RadObject.SuspendPropertyNotifications()
RadObject.ResumePropertyNotifications()
RadObject.GetPropertyValue(RadProperty)
RadObject.SetDefaultValueOverride(RadProperty, Object)
RadObject.SetValueAtDesignTime(RadProperty, Object)
RadObject.GetValue(RadProperty)
RadObject.SetValue(RadProperty, Object)
RadObject.ResetValue(RadProperty)
RadObject.ResetLocalValue(RadProperty)
RadObject.ResetValue(RadProperty, ValueResetFlags)
RadObject.UpdateValue(RadProperty)
RadObject.GetValueSource(RadProperty)
RadObject.GetRegisteredRadProperty(String)
RadObject.UpdateValueCore(RadPropertyValue)
RadObject.SetValueCore(RadPropertyValue, Object, Object, ValueSource)
RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)
RadObject.GetDefaultValue(RadPropertyValue, Object)
RadObject.CoerceValue(RadPropertyValue, Object)
RadObject.ShouldSerializeProperty(PropertyDescriptor)
RadObject.ShouldSerializeProperty(RadProperty)
RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)
RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)
RadObject.UnbindProperty(RadProperty)
RadObject.AddStylePropertySetting(IPropertySetting)
RadObject.RemoveStylePropertySetting(IPropertySetting)
RadObject.RemoveStylePropertySetting(RadProperty)
RadObject.GetInheritedValue(RadProperty)
RadObject.OnNotifyPropertyChanged(String)
RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)
RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)
RadObject.PropertyValues
RadObject.IsDesignMode
RadObject.PropertyFilter
RadObject.RadObjectType
RadObject.BindingContext
RadObject.PropertyChanged
RadObject.RadPropertyChanged
RadObject.RadPropertyChanging
RadObject.ShouldSerializePropertyHandler
DisposableObject.GetBitState(Int64)
DisposableObject.SetBitState(Int64, Boolean)
DisposableObject.OnBitStateChanged(Int64, Boolean, Boolean)
DisposableObject.Dispose()
DisposableObject.Dispose(Boolean)
DisposableObject.PerformDispose(Boolean)
DisposableObject.DisposeUnmanagedResources()
DisposableObject.BitState
DisposableObject.Events
DisposableObject.IsDisposing
DisposableObject.IsDisposed
DisposableObject.Disposed
DisposableObject.Disposing
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.GridView.dll

Syntax

public abstract class GridViewDataColumn : GridViewColumn, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IEditorProvider, INotifyPropertyChangingEx, IDataConversionInfoProvider, IGridViewEventListener, ITypeDescriptorContext, IServiceProvider

Constructors

GridViewDataColumn()

Initializes a new instance of the GridViewDataColumn.

Declaration
public GridViewDataColumn()

GridViewDataColumn(String)

Initializes a new instance of the GridViewDataColumn.

Declaration
public GridViewDataColumn(string fieldName)
Parameters
System.String fieldName

A string value referring to the unique name of the column.

GridViewDataColumn(String, String)

Initializes a new instance of the GridViewDataColumn.

Declaration
public GridViewDataColumn(string uniqueName, string fieldName)
Parameters
System.String uniqueName

A string value referring to the unique name of the column.

System.String fieldName

A string value referring to the field name to which the column is bound.

Fields

AllowCellMergingProperty

Declaration
public static RadProperty AllowCellMergingProperty
Field Value
RadProperty

AllowFilteringProperty

Declaration
public static RadProperty AllowFilteringProperty
Field Value
RadProperty

AllowNaturalSortProperty

Declaration
public static RadProperty AllowNaturalSortProperty
Field Value
RadProperty

AllowSearchingProperty

Declaration
public static RadProperty AllowSearchingProperty
Field Value
RadProperty

AutoFilterDelayProperty

Declaration
public static RadProperty AutoFilterDelayProperty
Field Value
RadProperty

DataEditFormatStringProperty

Declaration
public static RadProperty DataEditFormatStringProperty
Field Value
RadProperty

DataSourceNullValueProperty

Declaration
public static RadProperty DataSourceNullValueProperty
Field Value
RadProperty

DataTypeConverterProperty

Declaration
public static RadProperty DataTypeConverterProperty
Field Value
RadProperty

DataTypeProperty

Declaration
public static RadProperty DataTypeProperty
Field Value
RadProperty

excelFormat

Declaration
protected DisplayFormatType? excelFormat
Field Value
System.Nullable<DisplayFormatType>

FormatInfoProperty

Declaration
public static RadProperty FormatInfoProperty
Field Value
RadProperty

FormatStringProperty

Declaration
public static RadProperty FormatStringProperty
Field Value
RadProperty

NullValueProperty

Declaration
public static RadProperty NullValueProperty
Field Value
RadProperty

UseDataTypeConverterWhenSortingProperty

Declaration
public static RadProperty UseDataTypeConverterWhenSortingProperty
Field Value
RadProperty

Properties

AllowCellMerging

Gets or sets value indicating whether cells in the column can be merged.

Declaration
public virtual bool AllowCellMerging { get; set; }
Property Value
System.Boolean

AllowFiltering

Gets or sets a value indicating whether the user can filter by this column.

Declaration
public virtual bool AllowFiltering { get; set; }
Property Value
System.Boolean

AllowNaturalSort

Gets or sets a value indicating whether clicking on the header cell of this column would allow the user to set natural (no) sort.

Declaration
public virtual bool AllowNaturalSort { get; set; }
Property Value
System.Boolean

AllowSearching

Gets or sets a value indicating whether the user can search by this column.

Declaration
public virtual bool AllowSearching { get; set; }
Property Value
System.Boolean

AutoFilterDelay

Gets or set the value in Milliseconds indicating delay between last key press and filtering operation."

Declaration
public virtual int AutoFilterDelay { get; set; }
Property Value
System.Int32

DataSourceNullValue

Gets or sets a value to the data source when the user enters a null value into a cell

Declaration
public object DataSourceNullValue { get; set; }
Property Value
System.Object

Implements
IDataConversionInfoProvider.DataSourceNullValue

DataType

Gets or sets the data type of the column.

Declaration
public virtual Type DataType { get; set; }
Property Value
System.Type

Implements
IDataConversionInfoProvider.DataType

DataTypeConverter

Gets or sets the data type converter.

Declaration
public TypeConverter DataTypeConverter { get; set; }
Property Value
System.ComponentModel.TypeConverter

The data type converter.

Implements
IDataConversionInfoProvider.DataTypeConverter

DesiredEvents

Gets the event type(s) this listener needs to process.

Declaration
public GridEventType DesiredEvents { get; }
Property Value
GridEventType

Implements
IGridViewEventListener.DesiredEvents

DesiredProcessMode

Gets the event process mode for this instance.

Declaration
public GridEventProcessMode DesiredProcessMode { get; }
Property Value
GridEventProcessMode

Implements
IGridViewEventListener.DesiredProcessMode

DistinctValues

Gets the distinct values.

Declaration
public virtual GridViewColumnValuesCollection DistinctValues { get; }
Property Value
GridViewColumnValuesCollection

The distinct values.

DistinctValuesWithFilter

Gets the distinct values with filter.

Declaration
public virtual GridViewColumnValuesCollection DistinctValuesWithFilter { get; }
Property Value
GridViewColumnValuesCollection

The distinct values with filter.

ExcelExportFormatString

Gets or sets the excel export format string. Note that this format is considered only if ExcelExportType property is set to Custom.

Declaration
public string ExcelExportFormatString { get; set; }
Property Value
System.String

The excel export format string.

ExcelExportType

Gets or sets the type of the excel export.

Declaration
public virtual DisplayFormatType ExcelExportType { get; set; }
Property Value
DisplayFormatType

The type of the excel export.

FilterDescriptor

Gets or sets the filter descriptor.

Declaration
public virtual FilterDescriptor FilterDescriptor { get; set; }
Property Value
FilterDescriptor

The filter descriptor.

FormatInfo

Gets or sets the culture info used when formatting cell values.

Declaration
[SerializationConverter(typeof(FormatInfoSerializationCoverter))]
public CultureInfo FormatInfo { get; set; }
Property Value
System.Globalization.CultureInfo

Implements
IDataConversionInfoProvider.FormatInfo

FormatString

Gets or sets the format string applied to the textual content of each cell in the column.

Declaration
public string FormatString { get; set; }
Property Value
System.String

Implements
IDataConversionInfoProvider.FormatString

NullValue

Gets or sets the cell display value corresponding to a cell value of System.DBNull or null

Declaration
public object NullValue { get; set; }
Property Value
System.Object

Implements
IDataConversionInfoProvider.NullValue

Priority

Gets the priority of the current instance.

Declaration
public EventListenerPriority Priority { get; }
Property Value
EventListenerPriority

Implements
IGridViewEventListener.Priority

UseDataTypeConverterWhenSorting

Gets or sets a value indicating whether the data type converter of this column should be used when sorting.

Declaration
public bool UseDataTypeConverterWhenSorting { get; set; }
Property Value
System.Boolean

Methods

AnalyzeQueue(List<GridViewEvent>)

Declaration
public bool AnalyzeQueue(List<GridViewEvent> events)
Parameters
System.Collections.Generic.List<GridViewEvent> events

Returns
System.Boolean

Implements
IGridViewEventListener.AnalyzeQueue(List<GridViewEvent>)

CreateSnapshot()

Creates the snapshot.

Declaration
public void CreateSnapshot()

GetCellType(GridViewRowInfo)

Returns the type of cell element to be created for the specified row.

Declaration
public override Type GetCellType(GridViewRowInfo row)
Parameters
GridViewRowInfo row

The specified row.

Returns
System.Type

The type of the cell to be created.

Overrides
GridViewColumn.GetCellType(GridViewRowInfo)

GetDefaultDataTypeConverter(Type)

Gets the default data type converter.

Declaration
protected virtual TypeConverter GetDefaultDataTypeConverter(Type type)
Parameters
System.Type type

The type.

Returns
System.ComponentModel.TypeConverter

GetDistinctValues()

Gets the distinct values.

Declaration
protected virtual GridViewColumnValuesCollection GetDistinctValues()
Returns
GridViewColumnValuesCollection

GetDistinctValuesWithFilter()

Gets the distinct values with filter.

Declaration
protected virtual GridViewColumnValuesCollection GetDistinctValuesWithFilter()
Returns
GridViewColumnValuesCollection

GetEventInfo(RadProperty, out GridEventDispatchMode)

Gets the event info.

Declaration
protected override GridEventType GetEventInfo(RadProperty property, out GridEventDispatchMode dispatchMode)
Parameters
RadProperty property

The property.

GridEventDispatchMode dispatchMode

The dispatch mode.

Returns
GridEventType

Overrides
GridViewColumn.GetEventInfo(RadProperty, out GridEventDispatchMode)

Initialize()

Initializes the column.

Declaration
protected override void Initialize()
Overrides
GridViewColumn.Initialize()
Remarks

This method is called when the column is associated with GridViewTemplate.

OnNotifyPropertyChanging(PropertyChangingEventArgsEx)

Declaration
protected override void OnNotifyPropertyChanging(PropertyChangingEventArgsEx e)
Parameters
PropertyChangingEventArgsEx e

Overrides
GridViewColumn.OnNotifyPropertyChanging(PropertyChangingEventArgsEx)

OnPropertyChanged(RadPropertyChangedEventArgs)

Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

Overrides
GridViewColumn.OnPropertyChanged(RadPropertyChangedEventArgs)

PostProcessEvent(GridViewEvent)

Allows additional processing of an event that has been just dispatched.

Declaration
public GridViewEventResult PostProcessEvent(GridViewEvent eventData)
Parameters
GridViewEvent eventData

Returns
GridViewEventResult

Implements
IGridViewEventListener.PostProcessEvent(GridViewEvent)

PreProcessEvent(GridViewEvent)

Allows previewing of an event that is about to be dispatched.

Declaration
public GridViewEventResult PreProcessEvent(GridViewEvent eventData)
Parameters
GridViewEvent eventData

Returns
GridViewEventResult

Implements
IGridViewEventListener.PreProcessEvent(GridViewEvent)

ProcessEvent(GridViewEvent)

Core entry point for receiving and processing an event.

Declaration
public GridViewEventResult ProcessEvent(GridViewEvent eventData)
Parameters
GridViewEvent eventData

Returns
GridViewEventResult

Implements
IGridViewEventListener.ProcessEvent(GridViewEvent)

ToString()

Returns a string representation of the column.

Declaration
public override string ToString()
Returns
System.String

The string representation for the column.

Overrides
GridViewColumn.ToString()

UpdateDistinctValues()

Updates the distinct values.

Declaration
protected virtual void UpdateDistinctValues()

UpdateDistinctValuesOnAdd(Object)

Updates the distinct values on add.

Declaration
protected virtual void UpdateDistinctValuesOnAdd(object value)
Parameters
System.Object value

The value.

UpdateDistinctValuesOnAddWithFilter(Object)

Updates the distinct values on add with filter.

Declaration
protected virtual void UpdateDistinctValuesOnAddWithFilter(object value)
Parameters
System.Object value

The value.

UpdateDistinctValuesWithFilter()

Updates the distinct values with filter.

Declaration
protected virtual void UpdateDistinctValuesWithFilter()

Explicit Interface Implementations

IServiceProvider.GetService(Type)

Declaration
object IServiceProvider.GetService(Type serviceType)
Parameters
System.Type serviceType

Returns
System.Object

Implements
System.IServiceProvider.GetService(System.Type)

Extension Methods

CommonExtensions.ClearIfNoBindingAndSet(RadObject, RadProperty)
DispatcherExtensions.CheckAccess(RadObject)
CommonExtensions.SetIfDifferent(RadObject, RadProperty, Object)
CommonExtensions.ClearIfSet(RadObject, RadProperty)
CommonExtensions.IsLocalValueSet(RadObject, RadProperty)
DispatcherExtensions.CheckAccess(RadObject)
DispatcherExtensions.CheckAccess(RadObject)
DispatcherExtensions.CheckAccess(RadObject)
SvgExtentions.Traverse<T>(T, Func<T, IEnumerable<T>>)
SvgExtentions.TraverseDepthFirst<T>(T, Func<T, IEnumerable<T>>)
Getting Started
  • Install Now
  • Demos
  • Step-by-Step Tutorial
  • Sample Applications
  • SDK Samples
  • Visual Studio Extensions
Support Resources
  • Code Library
  • Knowledge Base
  • Videos
Community
  • Forums
  • Blogs
  • Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.