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, HyperLinkLinkButton, e quaisquer controles de validação. O CheckBoxListe DataList também não renderizam essa propriedade em navegadores anteriores quando sua RepeatLayout propriedade é definida RepeatLayout.Flowcomo . RadioButtonList Além disso, há suporte apenas para tipos de unidade de Pixel e Percentage em navegadores anteriores.

Como essa propriedade não é HTML padrão, os controles de servidor Web que são exibidos como uma tabela, como Table e DataGrid, não dão suporte a essa propriedade em navegadores anteriores à Internet da Microsoft 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