Freigeben über

WebControl.Height Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die Höhe des Webserversteuerelements ab oder legt sie fest.

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

Eigenschaftswert

Unit

A Unit , das die Höhe des Steuerelements darstellt. Der Standardwert lautet Empty.

Attribute
BindableAttribute

Ausnahmen

ArgumentException

Die Höhe wurde auf einen negativen Wert festgelegt.

Beispiele

Das folgende Beispiel veranschaulicht, wie die Height Eigenschaft des Table Steuerelements deklarativ festgelegt wird, die von der WebControl Basisklasse geerbt wird.

<%@ 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 Webserversteuerelements anzugeben.

Hinweis

Diese Eigenschaft wird nicht für alle Steuerelemente in Browsern vor Microsoft Internet Explorer, Version 4, gerendert. Steuerelemente, die diese Eigenschaft in früheren Browsern nicht rendern, umfassen Label, HyperLink, LinkButtonund alle Überprüfungssteuerelemente. Die CheckBoxListEigenschaft RadioButtonList und DataList rendern diese Eigenschaft auch nicht in früheren Browsern, wenn ihre RepeatLayout Eigenschaft auf " RepeatLayout.Flow. Darüber hinaus werden nur Einheitentypen von Pixel und Percentage werden in früheren Browsern unterstützt.

Da es sich bei dieser Eigenschaft um nicht standardmäßige HTML handelt, werden Webserversteuerelemente, die als Tabelle angezeigt werden, wie Table z. B. und DataGrid, diese Eigenschaft nicht in Browsern unterstützt, die älter als Microsoft Internet Explorer, Version 4, sind.

Hinweis

Wenn Sie die Height Eigenschaft auf einen anderen Einheitentyp als den Standardwert Pixelfestlegen möchten, müssen Sie einen neuen Einheitstyp erstellen, der für den gewünschten Einheitentyp spezifisch ist. Wenn Sie beispielsweise die Eigenschaft eines Steuerelements Height auf einen Prozentwert von 100 festlegen möchten, können Sie wie folgt vorgehen:

myWebControl.Width = Unit.Percentage(100);

Weitere Informationen zu den für die Height Eigenschaft verfügbaren Einheitentypen finden Sie in der Unit Klasse.

Gilt für:

Weitere Informationen