WebControl.DisabledCssClass Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la classe CSS à appliquer à l’élément HTML rendu 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, setPublic Shared Property DisabledCssClass As StringValeur de propriété
Classe CSS qui doit être appliquée à l’élément HTML rendu lorsque le contrôle est désactivé. La valeur par défaut est « aspNetDisabled ».
Exemples
L’exemple suivant montre le rendu HTML d’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 rendu 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 rendu pour la DisabledCssClass propriété de contrôles Web individuels. Par défaut, cette propriété retourne « aspNetDisabled ».
En cas SupportsDisabledAttribute de substitution dans une classe dérivée à retourner false, la valeur de la DisabledCssClass propriété est rendue en tant que valeur de l’attribut de l’élément class HTML pour le contrôle. Dans ce cas, s’il existe une valeur dans la CssClass propriété, 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. Quelle que soit la valeur à laquelle vous définissez est utilisée pour tous les contrôles d’une application web. Vous ne pouvez pas spécifier de valeurs différentes pour des contrôles individuels.
Si vous souhaitez utiliser un nom de classe différent de la valeur par défaut de « aspNetDisabled », vous placez généralement le code pour ce 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";
}
