Gets or sets the width of the Web server control.
[Visual Basic]
Public Overridable Property Width As Unit
[C#]
public virtual Unit Width {get; set;}
[C++]
public: __property virtual Unit get_Width();
public: __property virtual void set_Width(Unit);
[JScript]
public function get Width() : Unit;
public function set Width(Unit); Property Value
A Unit that represents the width of the control. The default is Unit.Empty.
Exceptions
| Exception Type | Condition |
| ArgumentException | The width of the Web server control was set to a negative value. |
Remarks
Use the Width property to specify the width of the Web server control.
Note This property does not render for all controls in browsers earlier than Microsoft Internet Explorer version 4. Controls that do not render this property in earlier browsers include Label, HyperLink, LinkButton, and any validation controls. The CheckBoxList, RadioButtonList and DataList also do not render this property in earlier browsers when their RepeatLayout property is set to RepeatLayout.Flow. Furthermore, only unit types of Pixel and Percentage are supported in earlier browsers.
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.
Example
[Visual Basic, C#, JScript] The following example illustrates how to declaratively set the Width property of the Table control, inherited from the WebControl base class.
[Visual Basic]
<%@ 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>
[C#]
<%@ 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>
[JScript]
<%@ 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>
[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button .gif)
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
WebControl Class | WebControl Members | System.Web.UI.WebControls Namespace | Style