BaseDataList.GridLines Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

GridLines

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

Attributes: BindableAttribute

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

Share via