WebControl.Height-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Property Height As Unit
'Usage
Dim instance As WebControl
Dim value As Unit

value = instance.Height

instance.Height = value

public virtual Unit Height { get; set; }

public:
virtual property Unit Height {
    Unit get ();
    void set (Unit value);
}

/** @property */
public Unit get_Height ()

/** @property */
public void set_Height (Unit value)

public function get Height () : Unit

public function set Height (value : Unit)

Eigenschaftenwert

Eine Unit, die die Höhe des Steuerelements darstellt. Der Standardwert ist Empty.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Die Höhe wurde auf einen negativen Wert festgelegt.

Hinweise

Mit der Height-Eigenschaft geben Sie die Höhe des Webserversteuerelements an.

Hinweis

Bei älteren Browsern als Microsoft Internet Explorer, Version 4, wird diese Eigenschaft nicht bei allen Steuerelementen dargestellt. Steuerelemente, die diese Eigenschaft nicht in älteren Browsern darstellen, sind Label, HyperLink, LinkButton und sämtliche Validierungssteuerelemente. CheckBoxList, RadioButtonList und DataList stellen diese Eigenschaft ebenfalls nicht in älteren Browsern dar, wenn die RepeatLayout-Eigenschaft dieser Steuerelemente auf RepeatLayout.Flow festgelegt ist. Außerdem unterstützen ältere Browser nur die Einheiten Pixel und Percentage.

Da diese Eigenschaft keine HTML-Standardeigenschaft ist, wird sie von als Tabelle dargestellten Webserversteuerelementen, z. B. Table und DataGrid, in älteren Browsern als Microsoft Internet Explorer, Version 4, nicht unterstützt.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie die Height-Eigenschaft des von der WebControl-Basisklasse geerbten Table-Steuerelements deklarativ festgelegt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 <body>
     <h3>Height Property of a Web Control</h3>
 
 <form runat="server">
 
 <asp:Table id="Table1" runat="server"
    CellPadding="10" 
    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>
 
 </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <body>
     <h3>Height Property of a Web Control</h3>
 
 <form runat="server">
 
 <asp:Table id="Table1" runat="server"
    CellPadding="10" 
    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>
 
 </form>
 
 </body>
 </html>

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
 <body>
     <h3>Height Property of a Web Control</h3>
 
 <form runat="server">
 
 <asp:Table id="Table1" runat="server"
    CellPadding="10" 
    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>
 
 </form>
 
 </body>
 </html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebControl-Klasse
WebControl-Member
System.Web.UI.WebControls-Namespace
Style-Klasse
Unit-Struktur
Label-Klasse
HyperLink-Klasse
LinkButton-Klasse
CheckBoxList-Klasse
RadioButtonList-Klasse
DataList-Klasse
RepeatLayout-Enumeration
Table-Klasse
DataGrid-Klasse

Weitere Ressourcen

ASP.NET-Webserversteuerelemente und Browserfunktionen
Syntax des Webserversteuerelements
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen

Freigeben über