Compartilhar via


HtmlTableCell.ColSpan Propriedade

Definição

Obtém ou define o número de colunas ocupadas por uma célula representada por uma instância da classe HtmlTableCell.

public:
 property int ColSpan { int get(); void set(int value); };
public int ColSpan { get; set; }
member this.ColSpan : int with get, set
Public Property ColSpan As Integer

Valor da propriedade

Int32

O número de colunas ocupado pela célula representada por uma instância do HtmlTableCell. O valor padrão é -1, que indica que essa propriedade não está definida.

Exemplos

O exemplo de código a seguir demonstra como usar a ColSpan propriedade para especificar que a célula na primeira linha do HtmlTable controle ocupa duas colunas.

<%@ 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
   <title>HtmlTableCell Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>HtmlTableCell Example</h3>

          <table id="Table1" runat="server" 
                style="border-width: 1; border-color: Black">

         <tr>
            <td colspan="2">
               Cell 1.
            </td>
         </tr>
         <tr>
            <td>
               Cell 3.
            </td>
            <td>
               Cell 4.
            </td>
         </tr>

      </table>      

   </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
   <title>HtmlTableCell Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>HtmlTableCell Example</h3>

          <table id="Table1" runat="server" 
                style="border-width: 1; border-color: Black">

         <tr>
            <td colspan="2">
               Cell 1.
            </td>
         </tr>
         <tr>
            <td>
               Cell 3.
            </td>
            <td>
               Cell 4.
            </td>
         </tr>

      </table>      

   </form>

</body>
</html>

Comentários

Em uma célula representada por uma instância da classe, use a HtmlTableCell ColSpan propriedade para especificar o número de colunas que a célula ocupa. Isso permite que você crie uma célula na tabela que ocupa mais de uma coluna. Por exemplo, suponha que você tenha uma tabela que contém duas colunas e duas linhas. Você pode criar uma célula de título de tabela que abrange ambas as colunas. Defina a ColSpan propriedade da célula mais à esquerda na primeira linha para 2 indicar que essa célula ocupa duas colunas na tabela.

Cuidado

Ao estender colunas, defina uma célula a menos na linha para cada coluna que você abrange. Por exemplo, se você abranger duas colunas, defina uma célula a menos na linha atual. Caso contrário, essa linha será maior que o número de colunas na tabela e a tabela não será exibida conforme o esperado.

Aplica-se a

Confira também