WebControl.Height WebControl.Height WebControl.Height WebControl.Height Property

Definizione

Ottiene o imposta l'altezza del controllo server Web.Gets or sets the height of the Web server control.

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; }
member this.Height : System.Web.UI.WebControls.Unit with get, set
Public Overridable Property Height As Unit

Valore della proprietà

Oggetto Unit che rappresenta l'altezza del controllo.A Unit that represents the height of the control. Il valore predefinito è Empty.The default is Empty.

Eccezioni

È stato specificato un valore negativo per l'altezza.The height was set to a negative value.

Esempi

L'esempio seguente illustra come impostare in modo dichiarativo il Height proprietà del Table controllo ereditato dal WebControl classe di base.The following example illustrates how to declaratively set the Height property of the Table control, inherited from the WebControl base class.

<%@ 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>

Commenti

Usare il Height proprietà per specificare l'altezza del controllo server Web.Use the Height property to specify the height of the Web server control.

Nota

Questa proprietà non esegue il rendering per tutti i controlli nei browser precedenti a Microsoft Internet Explorer versione 4.This property does not render for all controls in browsers earlier than Microsoft Internet Explorer version 4. Includono i controlli che non eseguono il rendering di questa proprietà nei browser meno recenti Label, HyperLink, LinkButtone ai controlli di convalida.Controls that do not render this property in earlier browsers include Label, HyperLink, LinkButton, and any validation controls. Il CheckBoxList, RadioButtonList e DataList anche questa proprietà nei browser meno recenti non vengono visualizzati quando loro RepeatLayout viene impostata su RepeatLayout.Flow.The CheckBoxList, RadioButtonList and DataList also do not render this property in earlier browsers when their RepeatLayout property is set to RepeatLayout.Flow. Inoltre, solo i tipi di unità Pixel e Percentage sono supportati nei browser meno recenti.Furthermore, only unit types of Pixel and Percentage are supported in earlier browsers.

Poiché questa proprietà è conforme allo standard HTML, controlli server Web che mostrano come una tabella, ad esempio Table e DataGrid, non supportano questa proprietà nei browser precedenti a Microsoft Internet Explorer versione 4.Because this property is nonstandard HTML, Web server controls that display as a table, such as Table and DataGrid, do not support this property in browsers earlier than Microsoft Internet Explorer version 4.

Nota

Per impostare il Height proprietà a un'unità di tipo diverso da quello predefinito di Pixel, è necessario creare un nuovo tipo di unità specifiche per il tipo di unità desiderata.To set the Height property to a unit type other than the default of Pixel, you must create a new unit type specific to the unit type you want. Ad esempio, per impostare un controllo Height proprietà su un valore percentuale pari a 100, è possibile eseguire le operazioni seguenti:For example, to set a control's Height property to a percentage value of 100, you could do the following:

myWebControl.Width = Unit.Percentage(100);

Per altre informazioni sui tipi di unità disponibili per il Height proprietà, vedere il Unit classe.For more information on the unit types available for the Height property, see the Unit class.

Si applica a

Vedi anche