WebControl.Height Proprietà

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; }
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à

Unit

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.

Attributi

Eccezioni

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

Esempio

Nell'esempio seguente viene illustrato come impostare in modo dichiarativo la proprietà Height del controllo Table, ereditata dalla classe di base WebControl.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

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

Nota

Non viene eseguito il rendering di questa proprietà 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. I controlli che non eseguono il rendering di questa proprietà nei browser precedenti includono Label, HyperLink, LinkButtone tutti i controlli di convalida.Controls that do not render this property in earlier browsers include Label, HyperLink, LinkButton, and any validation controls. Anche CheckBoxList, RadioButtonList e DataList non eseguono il rendering di questa proprietà nei browser precedenti quando la relativa proprietà RepeatLayout è 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, nei browser precedenti sono supportati solo i tipi di unità di Pixel e Percentage.Furthermore, only unit types of Pixel and Percentage are supported in earlier browsers.

Poiché questa proprietà è HTML non standard, i controlli server Web che vengono visualizzati come 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 la proprietà Height su un tipo di unità diverso da quello predefinito di Pixel, è necessario creare un nuovo tipo di unità specifico per il tipo di unità desiderato.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 la proprietà Height di un controllo su un valore percentuale di 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 ulteriori informazioni sui tipi di unità disponibili per la proprietà Height, vedere la classe Unit.For more information on the unit types available for the Height property, see the Unit class.

Si applica a

Vedi anche