WebControl.DisabledCssClass Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ottiene o imposta la classe CSS da applicare all'elemento HTML sottoposto a rendering quando il controllo è disabilitato.

public:
 static property System::String ^ DisabledCssClass { System::String ^ get(); void set(System::String ^ value); };

public static string DisabledCssClass { get; set; }

static member DisabledCssClass : string with get, set

Public Shared Property DisabledCssClass As String

Valore della proprietà

String

Classe CSS che deve essere applicata all'elemento HTML sottoposto a rendering quando il controllo è disabilitato. Il valore predefinito è "aspNetDisabled".

Esempio

Nell'esempio seguente viene illustrato il rendering del codice HTML per un controllo disabilitato Label quando la SupportsDisabledAttribute proprietà è false, quando la DisabledCssClass proprietà ha il valore predefinito e quando la CssClass proprietà è vuota.

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

Nell'esempio seguente viene illustrato il rendering del codice HTML nelle stesse condizioni, ad eccezione del fatto che la CssClass proprietà ha il valore "SampleStyle":

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

Per ulteriori informazioni, consultare la proprietà SupportsDisabledAttribute.

Commenti

Questa proprietà può essere utilizzata per modificare il nome di cui viene eseguito il rendering per la DisabledCssClass proprietà di singoli controlli Web. Per impostazione predefinita, questa proprietà restituisce "aspNetDisabled".

Quando SupportsDisabledAttribute viene sottoposto a override in una classe derivata per restituire false, il valore della DisabledCssClass proprietà viene sottoposto a rendering come valore dell'attributo dell'elemento class HTML per il controllo. In tal caso, se nella proprietà è presente un valore CssClass , entrambe le classi CSS verranno applicate all'elemento HTML sottoposto a rendering. L'attributo class sarà costituito dal valore della DisabledCssClass proprietà seguito dal valore della CssClass proprietà, separato da uno spazio.

Questa proprietà è statica, ovvero è possibile impostarla solo per la WebControl classe . Qualsiasi valore impostato su viene usato per tutti i controlli in un'applicazione Web. Non è possibile specificare valori diversi per singoli controlli.

Se si vuole usare un nome di classe diverso dal valore predefinito "aspNetDisabled", in genere si inserisce il codice per eseguire questa operazione nel Application_Start metodo del file Global.asax, come illustrato nell'esempio seguente:

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";
}

Vedi anche

• RenderingCompatibility
• SupportsDisabledAttribute
• Enabled
• IsEnabled