Compartilhar via


WebControl.DisabledCssClass Propriedade

Definição

Obtém ou define a classe CSS a ser aplicada ao elemento HTML renderizado quando o controle é desabilitado.

public:
 static property System::String ^ DisabledCssClass { System::String ^ get(); void set(System::String ^ value); };
public static string DisabledCssClass { get; set; }
member this.DisabledCssClass : string with get, set
Public Shared Property DisabledCssClass As String

Valor da propriedade

String

A classe CSS que deve ser aplicada ao elemento HTML renderizado quando o controle é desabilitado. O valor padrão é "aspNetDisabled".

Exemplos

O exemplo a seguir mostra HTML renderizado para um controle desabilitado Label quando a SupportsDisabledAttribute propriedade é false, quando a DisabledCssClass propriedade tem seu valor padrão e quando a CssClass propriedade está vazia.

<span id="Label1" class="aspNetDisabled">Test</span>

O exemplo a seguir mostra HTML renderizado nas mesmas condições, exceto que a CssClass propriedade tem o valor "SampleStyle":

<span id="Label1" class="aspNetDisabled SampleStyle">Test</span>

Para obter mais informações, consulte a propriedade SupportsDisabledAttribute.

Comentários

Essa propriedade pode ser usada para alterar o nome que é renderizado para a DisabledCssClass propriedade de controles Web individuais. Por padrão, essa propriedade retorna "aspNetDisabled".

Quando SupportsDisabledAttribute é substituído em uma classe derivada a ser retornada false, o valor da DisabledCssClass propriedade é renderizado como o valor do class atributo do elemento HTML para o controle. Nesse caso, se houver um valor na CssClass propriedade, ambas as classes CSS serão aplicadas ao elemento HTML renderizado. O class atributo consistirá no valor da DisabledCssClass propriedade seguido pelo valor da CssClass propriedade, separado por um espaço.

Essa propriedade é estática, o que significa que você pode defini-la apenas para a WebControl classe. Qualquer valor que você defini-lo é usado para todos os controles em um aplicativo Web. Você não pode especificar valores diferentes para controles individuais.

Se você quiser usar um nome de classe diferente do valor padrão de "aspNetDisabled", normalmente coloca o código para fazer isso no Application_Start método do arquivo Global.asax, conforme mostrado no exemplo a seguir:

Private Sub Application_Start(
    ByVal sender As Object, ByVal e As EventArgs)
    WebControl.DisabledCssClass = "customDisabledClassName"
End Sub
void Application_Start(object sender, EventArgs e)
{
    WebControl.DisabledCssClass = "customDisabledClassName";
}

Aplica-se a

Confira também