WebControl.DisabledCssClass Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit la classe CSS à appliquer à l'élément HTML restitué lorsque le contrôle est désactivé.

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

Valeur de propriété

String

Classe CSS qui doit être appliquée à l'élément HTML restitué lorsque le contrôle est désactivé. La valeur par défaut est "aspNetDisabled".

Exemples

L’exemple suivant montre le code HTML affiché pour un contrôle désactivé Label lorsque la SupportsDisabledAttribute propriété est false, lorsque la DisabledCssClass propriété a sa valeur par défaut et lorsque la CssClass propriété est vide.

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

L’exemple suivant montre le code HTML affiché dans les mêmes conditions, sauf que la CssClass propriété a la valeur « SampleStyle »:

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

Pour plus d'informations, consultez la propriété SupportsDisabledAttribute.

Remarques

Cette propriété peut être utilisée pour modifier le nom affiché pour la DisabledCssClass propriété de contrôles Web individuels. Par défaut, cette propriété renvoie « aspNetDisabled ».

Lorsque SupportsDisabledAttribute est substitué dans une classe dérivée pour retourner false, la valeur de la DisabledCssClass propriété est affichée en tant que valeur de l’attribut class de l’élément HTML pour le contrôle. Dans ce cas, si la propriété comporte une valeur CssClass , les deux classes CSS sont appliquées à l’élément HTML rendu. L’attribut class se compose de la valeur de la DisabledCssClass propriété suivie de la valeur de la CssClass propriété, séparée par un espace.

Cette propriété est statique, ce qui signifie que vous pouvez la définir uniquement pour la WebControl classe . La valeur que vous lui définissez est utilisée pour tous les contrôles d’une application web. Vous ne pouvez pas spécifier des valeurs différentes pour des contrôles individuels.

Si vous souhaitez utiliser un nom de classe différent de la valeur par défaut « aspNetDisabled », vous placez généralement le code pour le faire dans la Application_Start méthode du fichier Global.asax, comme illustré dans l’exemple suivant :

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

S’applique à

Voir aussi