WebControl.Height Eigenschaft

Definition

Ruft die Höhe des Webserversteuerelements ab oder legt diese fest.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

Eigenschaftswert

Eine Unit, die die Höhe des Steuerelements darstellt.A Unit that represents the height of the control. Der Standardwert lautet Empty.The default is Empty.

Attribute

Ausnahmen

Die Höhe wurde auf einen negativen Wert festgelegt.The height was set to a negative value.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Height-Eigenschaft des Table Steuer Elements deklarativ festgelegt wird, die von der WebControl-Basisklasse geerbt wurde.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>

Hinweise

Verwenden Sie die Height-Eigenschaft, um die Höhe des Webserver Steuer Elements anzugeben.Use the Height property to specify the height of the Web server control.

Hinweis

Diese Eigenschaft wird nicht für alle Steuerelemente in Browsern angezeigt, die älter sind als Microsoft Internet Explorer Version 4.This property does not render for all controls in browsers earlier than Microsoft Internet Explorer version 4. Steuerelemente, die diese Eigenschaft in früheren Browsern nicht Rendering enthalten, sind Label, HyperLink, LinkButtonund Validierungs Steuerelemente.Controls that do not render this property in earlier browsers include Label, HyperLink, LinkButton, and any validation controls. Die CheckBoxList, RadioButtonList und DataList auch diese Eigenschaft in früheren Browsern nicht, wenn deren RepeatLayout-Eigenschaft auf RepeatLayout.Flowfestgelegt ist.The CheckBoxList, RadioButtonList and DataList also do not render this property in earlier browsers when their RepeatLayout property is set to RepeatLayout.Flow. Außerdem werden in früheren Browsern nur Einheiten Typen von Pixel und Percentage unterstützt.Furthermore, only unit types of Pixel and Percentage are supported in earlier browsers.

Da diese Eigenschaft nicht dem Standard entsprechende HTML-Code entspricht, unterstützen Webserver Steuerelemente, die als Tabelle angezeigt werden (z. b. Table und DataGrid) diese Eigenschaft in Browsern vor Microsoft Internet Explorer Version 4 nicht.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.

Hinweis

Wenn Sie die Height-Eigenschaft auf einen anderen Einheitstyp als den Standardwert Pixelfestlegen möchten, müssen Sie einen neuen Einheitstyp erstellen, der für den gewünschten Einheitentyp spezifisch ist.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. Um z. b. die Height-Eigenschaft eines Steuer Elements auf einen prozentualen Wert von 100 festzulegen, können Sie Folgendes tun: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);

Weitere Informationen zu den für die Height-Eigenschaft verfügbaren Einheiten Typen finden Sie in der Unit-Klasse.For more information on the unit types available for the Height property, see the Unit class.

Gilt für:

Siehe auch