HtmlTable.CellPadding Property
Definition
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 the amount of space (in pixels) between the contents of a cell and the cell's border in the HtmlTable control.
public:
property int CellPadding { int get(); void set(int value); };public int CellPadding { get; set; }member this.CellPadding : int with get, setPublic Property CellPadding As IntegerProperty Value
The amount of space (in pixels) between the contents of a cell and the cell's border in the HtmlTable control. The default value is -1, which indicates that this property is not set.
Examples
The following code 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.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
// Set the HtmlTable properties according to the
// user selections.
Table1.CellSpacing = Convert.ToInt32(SpacingSelect.Value);
Table1.CellPadding = Convert.ToInt32(PaddingSelect.Value);
Table1.Align = AlignSelect.Value;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTable Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTable Example</h3>
<table id="Table1"
style="border-width:1; border-color: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>
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>
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>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs)
' Set the HtmlTable properties according to the
' user selections.
Table1.CellSpacing = CInt(SpacingSelect.Value)
Table1.CellPadding = CInt(PaddingSelect.Value)
Table1.Align = AlignSelect.Value
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTable Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTable Example</h3>
<table id="Table1"
style="border-width:1; border-color: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>
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>
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>
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.
