Table.GridLines Property

Definition

Gets or sets the grid line style to display in the Table control.

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 enumeration values. The default value is None.

Attributes

Examples

The following example demonstrates how to use the GridLines property to specify the grid line style.

Note

The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    private void Page_Load(Object sender, EventArgs e)
    {
        // Generate rows and cells.    
        int numrows = 5;
        int numcells = 4;
            
        for(int j=0; j<=numrows - 1; j++)
        {
            TableRow rw = new TableRow();
                
            for(int i=0; i <= numcells - 1; i++)
            {
               TableCell cel = new TableCell();
               cel.Controls.Add(new LiteralControl(
                   String.Format("row {0}, cell {1}", j, i)));
               rw.Cells.Add(cel);
            }
                
            Table1.Rows.Add(rw);
        }
    }

    private void Button_Click(Object sender, EventArgs e)
    { 
        Table1.GridLines = (GridLines)DropDown1.SelectedIndex;
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>Table GridLines Example</h3>

    <asp:Table id="Table1" 
        BorderColor="black" 
        BorderWidth="1" 
        GridLines="Both" 
        runat="server" />

    <br />GridLines:

    <asp:DropDownList id="DropDown1" 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">Both</asp:ListItem>
    </asp:DropDownList><br />

    <asp:button id="Button1"
        Text="Display Table"
        OnClick="Button_Click" 
        runat="server" />

    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Private Sub Page_Load(sender As Object, e As EventArgs) 
        ' Generate rows and cells.

        Dim numrows As Integer = 5
        Dim numcells As Integer = 4

        Dim i As Integer
        Dim j As Integer

        For j = 0 to numrows - 1
            Dim r As TableRow = new TableRow()
                
            For i = 0 to numcells - 1
                Dim c As TableCell = new TableCell()
                c.Controls.Add(New LiteralControl("row " & j.ToString() & _ 
                              ", cell " & i.ToString()))
                r.Cells.Add(c)
            Next ' i

            Table1.Rows.Add(r)
        Next ' j
    End Sub

    Private Sub Button_Click(sender As Object, e As EventArgs) 
        Table1.GridLines = CType(DropDown1.SelectedIndex, GridLines)
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>Table GridLines Example</h3>

    <asp:Table id="Table1" 
        BorderColor="black" 
        BorderWidth="1" 
        GridLines="Both" 
        runat="server" />

    <br />GridLines:

    <asp:DropDownList id="DropDown1" 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">Both</asp:ListItem>
    </asp:DropDownList><br />

    <asp:button id="Button1"
        Text="Display Table"
        OnClick="Button_Click" 
        runat="server" />

    </div>
    </form>
</body>
</html>

Remarks

Use the GridLines property to specify which cell borders are displayed in the Table control. The following table lists the different grid line styles.

GridLine value Description
None No cell borders are displayed.
Horizontal Only the horizontal cell borders are displayed.
Vertical Only the vertical cell borders are displayed.
Both Both the horizontal and vertical cell borders are displayed.

Applies to

See also