WebControl.Height Свойство

Определение

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

Значение свойства

Unit

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

Атрибуты

Исключения

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

Примеры

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

Комментарии

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

Примечание

Это свойство не отображается для всех элементов управления в браузерах, предшествующих 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.

Примечание

Чтобы задать 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.

Применяется к

См. также раздел