WebControl.Width-Eigenschaft

Artikel
08/20/2007

Ruft die Breite des Webserversteuerelements ab oder legt diese fest.

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

Syntax

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

value = instance.Width

instance.Width = value

public virtual Unit Width { get; set; }

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

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

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

public function get Width () : Unit

public function set Width (value : Unit)

Eigenschaftenwert

Eine Unit, die die Breite des Steuerelements darstellt. Der Standardwert ist Empty.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Die Breite des Webserversteuerelements wurde auf einen negativen Wert festgelegt.

Hinweise

Mit der Width-Eigenschaft geben Sie die Breite 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 Width-Eigenschaft des von der WebControl-Basisklasse geerbten Table-Steuerelements deklarativ festgelegt wird.

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

Weitere Ressourcen

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

Freigeben über