WebControl.Height Property

Definition

Получает или задает высоту серверного веб-элемента управления.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

Property Value

Unit

Unit представляет высоту элемента управления.A Unit that represents the height of the control. Значение по умолчанию — Empty.The default is Empty.

Attributes

Exceptions

В качестве высоты было указано отрицательное значение.The height was set to a negative value.

Examples

В следующем примере показано, как декларативно задать свойство Height элемента управления Table, унаследованного от базового класса 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>

Remarks

Используйте свойство Height, чтобы указать высоту серверного веб-элемента управления.Use the Height property to specify the height of the Web server control.

Note

Это свойство не отображается для всех элементов управления в браузерах, предшествующих Microsoft Internet Explorer версии 4.This property does not render for all controls in browsers earlier than Microsoft Internet Explorer version 4. Элементы управления, которые не отображают это свойство в более ранних браузерах, включают Label, HyperLink, LinkButtonи все элементы управления проверки.Controls that do not render this property in earlier browsers include Label, HyperLink, LinkButton, and any validation controls. CheckBoxList, RadioButtonList и DataList также не отображают это свойство в более ранних браузерах, если их свойство RepeatLayout имеет значение 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. Кроме того, в более ранних браузерах поддерживаются только типы единиц Pixel и Percentage.Furthermore, only unit types of Pixel and Percentage are supported in earlier browsers.

Поскольку это свойство является нестандартным HTML, элементы управления веб-сервера, отображаемые в виде таблицы, такие как Table и DataGrid, не поддерживают это свойство в браузерах, предшествующих Microsoft Internet Explorer версии 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.

Note

Чтобы задать для свойства Height тип единицы, отличный от значения по умолчанию для Pixel, необходимо создать новый тип единицы, относящийся к нужному типу единиц.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. Например, чтобы задать для свойства Height элемента управления значение в процентах, равное 100, можно сделать следующее: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);

Дополнительные сведения о типах единиц измерения, доступных для свойства Height, см. в разделе класс Unit.For more information on the unit types available for the Height property, see the Unit class.

Applies to

See also