WebControl.Height Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a altura do controle do servidor Web.

public:
 virtual property System::Web::UI::WebControls::Unit Height { System::Web::UI::WebControls::Unit get(); void set(System::Web::UI::WebControls::Unit value); };
[System.ComponentModel.Bindable(true)]
public virtual System.Web.UI.WebControls.Unit Height { get; set; }
public virtual System.Web.UI.WebControls.Unit Height { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Height : System.Web.UI.WebControls.Unit with get, set
member this.Height : System.Web.UI.WebControls.Unit with get, set
Public Overridable Property Height As Unit

Valor da propriedade

Unit

Um Unit que representa a altura do controle. O padrão é Empty.

Atributos
BindableAttribute

Exceções

ArgumentException

A altura foi definida como um valor negativo.

Exemplos

O exemplo a seguir ilustra como definir declarativamente a Height propriedade do Table controle herdada da WebControl classe base.

<%@ 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">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Table Property</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h3>Property of a Table Web Control</h3>
 
        <asp:Table id="Table1" runat="server"
            CellPadding = "10" 
            CellSpacing="0"
            GridLines="Both"
            Height="300">

            <asp:TableRow>
                <asp:TableCell>
                    Row 0, Col 0
                </asp:TableCell>
                <asp:TableCell>
                    Row 0, Col 1
                </asp:TableCell>
            </asp:TableRow>

            <asp:TableRow>
                <asp:TableCell>
                    Row 1, Col 0
                </asp:TableCell>
                <asp:TableCell>
                    Row 1, Col 1
                </asp:TableCell>
            </asp:TableRow>
        </asp:Table>
    </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">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Table Property</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h3>Property of a Table Web Control</h3>
 
        <asp:Table id="Table1" runat="server"
            CellPadding = "10" 
            CellSpacing="0"
            GridLines="Both"
            Height="300">

            <asp:TableRow>
                <asp:TableCell>
                    Row 0, Col 0
                </asp:TableCell>
                <asp:TableCell>
                    Row 0, Col 1
                </asp:TableCell>
            </asp:TableRow>

            <asp:TableRow>
                <asp:TableCell>
                    Row 1, Col 0
                </asp:TableCell>
                <asp:TableCell>
                    Row 1, Col 1
                </asp:TableCell>
            </asp:TableRow>
        </asp:Table>
    </div>
    </form>
</body>
</html>

Comentários

Use a Height propriedade para especificar a altura do controle do servidor Web.

Observação

Essa propriedade não é renderizada para todos os controles em navegadores anteriores ao Microsoft Internet Explorer versão 4. Os controles que não renderizam essa propriedade em navegadores anteriores incluem Label, HyperLink, LinkButtone quaisquer controles de validação. O CheckBoxListe RadioButtonListDataList também não renderizam essa propriedade em navegadores anteriores quando sua RepeatLayout propriedade é definida RepeatLayout.Flowcomo . Além disso, somente tipos de unidade de Pixel e Percentage têm suporte em navegadores anteriores.

Como essa propriedade não é html padrão, os controles de servidor Web exibidos como uma tabela, como Table e DataGrid, não dão suporte a essa propriedade em navegadores anteriores ao Microsoft Internet Explorer versão 4.

Observação

Para definir a Height propriedade como um tipo de unidade diferente do padrão de Pixel, você deve criar um novo tipo de unidade específico para o tipo de unidade desejado. Por exemplo, para definir a propriedade de Height um controle como um valor percentual de 100, você pode fazer o seguinte:

myWebControl.Width = Unit.Percentage(100);

Para obter mais informações sobre os tipos de unidade disponíveis para a Height propriedade, consulte a Unit classe .

Aplica-se a

Confira também