CellStyle Property
Collapse the table of content
Expand the table of content

DataGridViewCellFormattingEventArgs.CellStyle Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the style of the cell that is being formatted.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public DataGridViewCellStyle CellStyle { get; set; }
/** @property */
public DataGridViewCellStyle get_CellStyle ()

/** @property */
public void set_CellStyle (DataGridViewCellStyle value)

public function get CellStyle () : DataGridViewCellStyle

public function set CellStyle (value : DataGridViewCellStyle)

Property Value

A DataGridViewCellStyle that represents the display style of the cell being formatted. The default is the value of the cell's InheritedStyle property.

Setting the properties of the object returned by the CellStyle property will change how the cell and its contents are displayed. To avoid performance penalties, use this property to change the cell styles rather than accessing the cell directly.

For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control

The following code example demonstrates how to use the CellStyle property to color the background of cells that contain the string "Pink" to Pink.

private void dataGridView1_CellFormatting(object sender, DataGridViewCellFormattingEventArgs e)
    // If the column is the Artist column, check the
    // value.
    if (this.dataGridView1.Columns[e.ColumnIndex].Name == "Artist")
        if (e.Value != null)
            // Check for the string "pink" in the cell.
            string stringValue = (string)e.Value;
            stringValue = stringValue.ToLower();
            if ((stringValue.IndexOf("pink") > -1))
                e.CellStyle.BackColor = Color.Pink;

    else if (this.dataGridView1.Columns[e.ColumnIndex].Name == "Release Date")

//Even though the date internaly stores the year as YYYY, using formatting, the
//UI can have the format in YY.  
private static void ShortFormDateFormat(DataGridViewCellFormattingEventArgs formatting)
    if (formatting.Value != null)
            System.Text.StringBuilder dateString = new System.Text.StringBuilder();
            DateTime theDate = DateTime.Parse(formatting.Value.ToString());

            formatting.Value = dateString.ToString();
            formatting.FormattingApplied = true;
        catch (FormatException)
            // Set to false in case there are other handlers interested trying to
            // format this DataGridViewCellFormattingEventArgs instance.
            formatting.FormattingApplied = false;

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

© 2016 Microsoft