BaseDataList.GridLines Property

Definition

Gets or sets a value that specifies whether the border between the cells of a data listing control is displayed.

public:
 virtual property System::Web::UI::WebControls::GridLines GridLines { System::Web::UI::WebControls::GridLines get(); void set(System::Web::UI::WebControls::GridLines value); };
[System.ComponentModel.Bindable(true)]
public virtual System.Web.UI.WebControls.GridLines GridLines { get; set; }
public virtual System.Web.UI.WebControls.GridLines GridLines { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.GridLines : System.Web.UI.WebControls.GridLines with get, set
member this.GridLines : System.Web.UI.WebControls.GridLines with get, set
Public Overridable Property GridLines As GridLines

Property Value

One of the GridLines values. The default value is Both.

Attributes

Examples

The following code example demonstrates how to use the GridLines property to display both the horizontal and vertical gridlines in a data-bound control.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">
 
      ICollection CreateDataSource() 
      {
      
         // Create sample data for the DataGrid control.
         DataTable dt = new DataTable();
         DataRow dr;
 
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         // Load sample data only once when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsGrid.DataSource = CreateDataSource();
            ItemsGrid.DataBind();
         }

      }

      void Index_Change(Object sender, EventArgs e) 
      {

         ItemsGrid.GridLines = (GridLines)GridLinesList.SelectedIndex;

      }
 
   </script>
 
<head runat="server">
    <title>BaseDataList GridLines Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BaseDataList GridLines Example</h3>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           GridLines="Both"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 
 
      </asp:DataGrid>

      <br />

      <h4>Select the gridline style:</h4>

            <table cellpadding="5">

         <tr>

            <td>

               Gridline style:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="GridLinesList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Index_Change"
                    runat="server">

                  <asp:ListItem Value="0">None</asp:ListItem>
                  <asp:ListItem Value="1">Horizontal</asp:ListItem>
                  <asp:ListItem Value="2">Vertical</asp:ListItem>
                  <asp:ListItem Value="3" Selected="True">Both</asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>

      </table>
      
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">
 
      Function CreateDataSource() As ICollection 
      
         ' Create sample data for the DataGrid control.
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
 
         ' Define the columns of the table.
         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("StringValue", GetType(string)))
         dt.Columns.Add(New DataColumn("CurrencyValue", GetType(double)))
 
         ' Populate the table with sample values.
         Dim i As Integer

         For i = 0 to 8 
        
            dr = dt.NewRow()
 
            dr(0) = i
            dr(1) = "Item " & i.ToString()
            dr(2) = 1.23 * (i + 1)
 
            dt.Rows.Add(dr)

         Next i
 
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function
 
      Sub Page_Load(sender As Object, e As EventArgs) 
 
         ' Load sample data only once when the page is first loaded.
         If Not IsPostBack Then 
  
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()

         End If

      End Sub

      Sub Index_Change(sender As Object, e As EventArgs) 

         ItemsGrid.GridLines = CType(GridLinesList.SelectedIndex, GridLines)

      End Sub
 
   </script>
 
<head runat="server">
    <title>BaseDataList GridLines Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BaseDataList GridLines Example</h3>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           GridLines="Both"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 
 
      </asp:DataGrid>

      <br />

      <h4>Select the gridline style:</h4>

            <table cellpadding="5">

         <tr>

            <td>

               Gridline style:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="GridLinesList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Index_Change"
                    runat="server">

                  <asp:ListItem Value="0">None</asp:ListItem>
                  <asp:ListItem Value="1">Horizontal</asp:ListItem>
                  <asp:ListItem Value="2">Vertical</asp:ListItem>
                  <asp:ListItem Value="3" Selected="True">Both</asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>

      </table>
      
   </form>
 
</body>
</html>

Remarks

Use the GridLines property to specify whether the border between the cells of a data listing control is displayed. This property is set with one of the GridLines enumeration values. The following table lists the possible values.

Value Description
None No cell border is displayed.
Horizontal Only the upper and lower borders of the cells in a data listing control are displayed.
Vertical Only the left and right borders of the cells in the data list control are displayed.
Both All borders of the cells in a data listing control are displayed.

Applies to

See also