WebControl.Width Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define a largura do controlo do servidor Web.

public:
 virtual property System::Web::UI::WebControls::Unit Width { 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 Width { get; set; }
public virtual System.Web.UI.WebControls.Unit Width { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Width : System.Web.UI.WebControls.Unit with get, set
member this.Width : System.Web.UI.WebControls.Unit with get, set
Public Overridable Property Width As Unit

Valor de Propriedade

Unit

A Unit que representa a largura do controlo. A predefinição é Empty.

Atributos
BindableAttribute

Exceções

ArgumentException

A largura do controlo do servidor Web foi definida para um valor negativo.

Exemplos

O exemplo seguinte ilustra como definir declarativamente a Width propriedade do Table controlo, herdada da WebControl classe base.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
    <title>WebControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>Width Property of a Web Control</h3>
    <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>
 
    </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">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
    <title>WebControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    <h3>Width Property of a Web Control</h3>
    <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>
 
    </div>
    </form>
</body>
</html>

Observações

Use a Width propriedade para especificar a largura do controlo do servidor Web.

Note

Esta propriedade não é renderizada para todos os controlos nos navegadores anteriores à versão 4 Microsoft Internet Explorer. Controlos que não renderizam esta propriedade em navegadores anteriores incluem Label, HyperLink, LinkButton, e quaisquer controlos de validação. Os , e também não renderizam esta propriedade em navegadores anteriores quando a sua RepeatLayout propriedade está definida para RepeatLayout.Flow.DataListRadioButtonListCheckBoxList Além disso, apenas os tipos de unidades de Pixel e Percentage são suportados em navegadores mais antigos.

Como esta propriedade é HTML não padrão, os controlos de servidores web que exibem como tabela, como Table e DataGrid, não suportam esta propriedade em navegadores anteriores à Microsoft Internet Explorer versão 4.

Note

Para definir a Width propriedade declarativamente para um tipo de unidade diferente do padrão de Pixel, deve criar um novo tipo de unidade específico para o tipo de unidade que deseja. Por exemplo, para definir a propriedade de Width um controlo com um valor percentual de 100, pode fazer o seguinte:

myWebControl.width = Unit.Percentage(100);

Para mais informações sobre os tipos de unidades disponíveis para a Width propriedade, consulte a Unit classe.

Aplica-se a

Ver também