This documentation is archived and is not being maintained.

HtmlTable.CellPadding Property

Gets or sets the amount of space between the contents of a cell and the cell's border (in pixels) in the HtmlTable control.

[Visual Basic]
Public Property CellPadding As Integer
[C#]
public int CellPadding {get; set;}
[C++]
public: __property int get_CellPadding();
public: __property void set_CellPadding(int);
[JScript]
public function get CellPadding() : int;
public function set CellPadding(int);

Property Value

The amount of space between the contents of a cell and the cell's border (in pixels) in the HtmlTable control.

Remarks

Use the CellPadding property to control the spacing between the contents of a cell and the cell's border. The padding amount specified is added to all four sides of the cell. All cells in a column share the same cell width; therefore, the spacing is applied to the widest cell in the column. Similarly, all cells in the same row share the same cell height. The spacing is applied to the tallest cell in the row. Individual cell sizes cannot be specified.

Example

[Visual Basic, C#, JScript] The following example demonstrates how to use the CellPadding property to programmatically control the spacing between the contents of the cell and the cell's border in the HtmlTable control.

[Visual Basic] 
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      Sub Button_Click(sender As Object, e As EventArgs ) 

         Table1.CellSpacing = CInt(SpacingSelect.Value)
         Table1.CellPadding = CInt(PaddingSelect.Value)
         Table1.Align = AlignSelect.Value

      End Sub

   </script>

</head>
<body>

   <form runat="server">

      <h3>HtmlTable Example</h3>

      <table id="Table1" 
             Border="1" 
             BorderColor="black" 
             runat="server">

         <tr>
            <th>
               Column 1
            </th>
            <th>
               Column 2
            </th>
            <th>
               Column 3
            </th>
         </tr>
         <tr>
            <td>
               Cell 1
            </td>
            <td>
               Cell 2
            </td>
            <td>
               Cell 3
            </td>
         </tr>
         <tr>
            <td>
               Cell 4
            </td>
            <td>
               Cell 5
            </td>
            <td>
               Cell 6
            </td>
         </tr>

      </table>
      
      <br><br><br><br><br><br><br><br>
      
      <hr>

      Select the display settings: <br><br>

      Align:
      <select id="AlignSelect" 
              runat="server">

         <option Value="Left">Left</option>
         <option Value="Center">Center</option>
         <option Value="Right">Right</option>
        
      </select>

      &nbsp;&nbsp;

      CellPadding:
      <select id="PaddingSelect" 
              runat="server">

         <option Value="0">0</option>
         <option Value="1">1</option>
         <option Value="2">2</option>
         <option Value="3">3</option>
         <option Value="4">4</option>
         <option Value="5">5</option>

      </select>

      &nbsp;&nbsp;

      CellSpacing:
      <select id="SpacingSelect" 
              runat="server">

         <option Value="0">0</option>
         <option Value="1">1</option>
         <option Value="2">2</option>
         <option Value="3">3</option>
         <option Value="4">4</option>
         <option Value="5">5</option>

      </select>
       
      <br><br>
  
      <input type="button" 
             value="Generate Table"
             OnServerClick = "Button_Click" 
             runat="server"/>

   </form>

</body>
</html>

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      void Button_Click(Object sender, EventArgs e) 
      {

         Table1.CellSpacing = Convert.ToInt32(SpacingSelect.Value);
         Table1.CellPadding = Convert.ToInt32(PaddingSelect.Value);
         Table1.Align = AlignSelect.Value;

      }

   </script>

</head>
<body>

   <form runat="server">

      <h3>HtmlTable Example</h3>

      <table id="Table1" 
             Border="1" 
             BorderColor="black" 
             runat="server">

         <tr>
            <th>
               Column 1
            </th>
            <th>
               Column 2
            </th>
            <th>
               Column 3
            </th>
         </tr>
         <tr>
            <td>
               Cell 1
            </td>
            <td>
               Cell 2
            </td>
            <td>
               Cell 3
            </td>
         </tr>
         <tr>
            <td>
               Cell 4
            </td>
            <td>
               Cell 5
            </td>
            <td>
               Cell 6
            </td>
         </tr>

      </table>
      
      <br><br><br><br><br><br><br><br>
      
      <hr>

      Select the display settings: <br><br>

      Align:
      <select id="AlignSelect" 
              runat="server">

         <option Value="Left">Left</option>
         <option Value="Center">Center</option>
         <option Value="Right">Right</option>
        
      </select>

      &nbsp;&nbsp;

      CellPadding:
      <select id="PaddingSelect" 
              runat="server">

         <option Value="0">0</option>
         <option Value="1">1</option>
         <option Value="2">2</option>
         <option Value="3">3</option>
         <option Value="4">4</option>
         <option Value="5">5</option>

      </select>

      &nbsp;&nbsp;

      CellSpacing:
      <select id="SpacingSelect" 
              runat="server">

         <option Value="0">0</option>
         <option Value="1">1</option>
         <option Value="2">2</option>
         <option Value="3">3</option>
         <option Value="4">4</option>
         <option Value="5">5</option>

      </select>
       
      <br><br>
  
      <input type="button" 
             value="Generate Table"
             OnServerClick = "Button_Click" 
             runat="server"/>

   </form>

</body>
</html>

[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      function Button_Click(sender : Object, e : EventArgs) 
      {

         Table1.CellSpacing = Convert.ToInt32(SpacingSelect.Value);
         Table1.CellPadding = Convert.ToInt32(PaddingSelect.Value);
         Table1.Align = AlignSelect.Value;

      }

   </script>

</head>
<body>

   <form runat="server">

      <h3>HtmlTable Example</h3>

      <table id="Table1" 
             Border="1" 
             BorderColor="black" 
             runat="server">

         <tr>
            <th>
               Column 1
            </th>
            <th>
               Column 2
            </th>
            <th>
               Column 3
            </th>
         </tr>
         <tr>
            <td>
               Cell 1
            </td>
            <td>
               Cell 2
            </td>
            <td>
               Cell 3
            </td>
         </tr>
         <tr>
            <td>
               Cell 4
            </td>
            <td>
               Cell 5
            </td>
            <td>
               Cell 6
            </td>
         </tr>

      </table>
      
      <br><br><br><br><br><br><br><br>
      
      <hr>

      Select the display settings: <br><br>

      Align:
      <select id="AlignSelect" 
              runat="server">

         <option Value="Left">Left</option>
         <option Value="Center">Center</option>
         <option Value="Right">Right</option>
        
      </select>

      &nbsp;&nbsp;

      CellPadding:
      <select id="PaddingSelect" 
              runat="server">

         <option Value="0">0</option>
         <option Value="1">1</option>
         <option Value="2">2</option>
         <option Value="3">3</option>
         <option Value="4">4</option>
         <option Value="5">5</option>

      </select>

      &nbsp;&nbsp;

      CellSpacing:
      <select id="SpacingSelect" 
              runat="server">

         <option Value="0">0</option>
         <option Value="1">1</option>
         <option Value="2">2</option>
         <option Value="3">3</option>
         <option Value="4">4</option>
         <option Value="5">5</option>

      </select>
       
      <br><br>
  
      <input type="button" 
             value="Generate Table"
             OnServerClick = "Button_Click" 
             runat="server"/>

   </form>

</body>
</html>

[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

HtmlTable Class | HtmlTable Members | System.Web.UI.HtmlControls Namespace | Align | CellSpacing

Show: