Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DataGridTableStyle.BackColor Property

Gets or sets the background color of even-numbered rows of the grid.

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

public Color BackColor { get; set; }
/** @property */
public Color get_BackColor ()

/** @property */
public void set_BackColor (Color value)

public function get BackColor () : Color

public function set BackColor (value : Color)

Not applicable.

Property Value

A Color that represents the background color of odd-numbered rows.

The AlternatingBackColor property can also be set to create a ledger-like appearance.

The following code example creates an instance of DataGridTableStyle and sets the BackColor and AlternatingBackColor properties to new values. The example requires that you have a DataGrid with a System.Data.DataSet that contains some data, and a Button on a Form.

private void AddCustomDataTableStyle()
{
   myDataGridTableStyle1 = new DataGridTableStyle();
  
   // EventHandlers          
   myDataGridTableStyle1.GridLineColorChanged += new System.EventHandler(GridLineColorChanged_Handler);         
   myDataGridTableStyle1.MappingName = "Customers";

   // Set other properties.
   myDataGridTableStyle1.AlternatingBackColor=System.Drawing.Color.Gold;
   myDataGridTableStyle1.BackColor = System.Drawing.Color.White;
   myDataGridTableStyle1.GridLineStyle=System.Windows.Forms.DataGridLineStyle.Solid;
   myDataGridTableStyle1.GridLineColor=Color.Red;

   // Set the HeaderText and Width properties. 
   DataGridColumnStyle myBoolCol = new DataGridBoolColumn();
   myBoolCol.MappingName = "Current";
   myBoolCol.HeaderText = "IsCurrent Customer";
   myBoolCol.Width = 150;
   myDataGridTableStyle1.GridColumnStyles.Add(myBoolCol);

   // Add a second column style.
   DataGridColumnStyle myTextCol = new DataGridTextBoxColumn();
   myTextCol.MappingName = "custName";
   myTextCol.HeaderText = "Customer Name";
   myTextCol.Width = 250;
   myDataGridTableStyle1.GridColumnStyles.Add(myTextCol);

   // Create new ColumnStyle objects
   DataGridColumnStyle cOrderDate = new DataGridTextBoxColumn();
   cOrderDate.MappingName = "OrderDate";
   cOrderDate.HeaderText = "Order Date";
   cOrderDate.Width = 100;

   // Use a PropertyDescriptor to create a formatted column.
   PropertyDescriptorCollection myPropertyDescriptorCollection = BindingContext
      [myDataSet, "Customers.custToOrders"].GetItemProperties();
 
   // Create a formatted column using a PropertyDescriptor.
   DataGridColumnStyle csOrderAmount = 
      new DataGridTextBoxColumn(myPropertyDescriptorCollection["OrderAmount"], "c", true);
   csOrderAmount.MappingName = "OrderAmount";
   csOrderAmount.HeaderText = "Total";
   csOrderAmount.Width = 100;
        
   // Add the DataGridTableStyle instances to the GridTableStylesCollection.
   myDataGrid.TableStyles.Add(myDataGridTableStyle1);      
}      
private void GridLineColorChanged_Handler(object sender,EventArgs e)
{
   MessageBox.Show("GridLineColor Changed", "DataGridTableStyle");
}   

private void AddCustomDataTableStyle()
{
    myDataGridTableStyle1 = new DataGridTableStyle();

    // EventHandlers          
    myDataGridTableStyle1.add_GridLineColorChanged(
        new System.EventHandler(GridLineColorChanged_Handler));
    myDataGridTableStyle1.set_MappingName("Customers");

    // Set other properties.
    myDataGridTableStyle1.set_AlternatingBackColor(
        System.Drawing.Color.get_Gold());
    myDataGridTableStyle1.set_BackColor(System.Drawing.Color.get_White());
    myDataGridTableStyle1.set_GridLineStyle(
        System.Windows.Forms.DataGridLineStyle.Solid);
    myDataGridTableStyle1.set_GridLineColor(Color.get_Red());

    // Set the HeaderText and Width properties. 
    DataGridColumnStyle myBoolCol = new DataGridBoolColumn();

    myBoolCol.set_MappingName("Current");
    myBoolCol.set_HeaderText("IsCurrent Customer");
    myBoolCol.set_Width(150);
    myDataGridTableStyle1.get_GridColumnStyles().Add(myBoolCol);

    // Add a second column style.
    DataGridColumnStyle myTextCol = new DataGridTextBoxColumn();

    myTextCol.set_MappingName("custName");
    myTextCol.set_HeaderText("Customer Name");
    myTextCol.set_Width(250);
    myDataGridTableStyle1.get_GridColumnStyles().Add(myTextCol);

    // Create new ColumnStyle objects
    DataGridColumnStyle cOrderDate = new DataGridTextBoxColumn();

    cOrderDate.set_MappingName("OrderDate");
    cOrderDate.set_HeaderText("Order Date");
    cOrderDate.set_Width(100);

    // Use a PropertyDescriptor to create a formatted column.
    PropertyDescriptorCollection myPropertyDescriptorCollection = 
        get_BindingContext().get_Item(myDataSet, 
        "Customers.custToOrders").GetItemProperties();

    // Create a formatted column using a PropertyDescriptor.
    DataGridColumnStyle csOrderAmount = new DataGridTextBoxColumn(
        myPropertyDescriptorCollection.get_Item("OrderAmount"), "c", true);

    csOrderAmount.set_MappingName("OrderAmount");
    csOrderAmount.set_HeaderText("Total");
    csOrderAmount.set_Width(100);

    // Add the DataGridTableStyle instances to the 
    // GridTableStylesCollection.
    myDataGrid.get_TableStyles().Add(myDataGridTableStyle1);
} //AddCustomDataTableStyle

private void GridLineColorChanged_Handler(Object sender, EventArgs e)
{
    MessageBox.Show("GridLineColor Changed", "DataGridTableStyle");
} //GridLineColorChanged_Handler

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

Show:
© 2014 Microsoft