WebControl.DisabledCssClass Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die CSS-Klasse ab, die auf das gerenderte HTML-Element angewendet werden soll, wenn das Steuerelement deaktiviert ist, oder legt sie fest.
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 StringEigenschaftswert
Die CSS-Klasse, die auf das gerenderte HTML-Element angewendet werden soll, wenn das Steuerelement deaktiviert ist. Der Standardwert ist "aspNetDisabled".
Beispiele
Das folgende Beispiel zeigt gerenderte HTML für ein deaktiviertes Label Steuerelement, wenn die SupportsDisabledAttribute Eigenschaft den falseDisabledCssClass Standardwert aufweist und wenn die CssClass Eigenschaft leer ist.
<span id="Label1" class="aspNetDisabled">Test</span>
Das folgende Beispiel zeigt gerenderte HTML unter den gleichen Bedingungen, mit der Ausnahme, dass die CssClass Eigenschaft den Wert "SampleStyle" aufweist.:
<span id="Label1" class="aspNetDisabled SampleStyle">Test</span>
Weitere Informationen finden Sie in den Ausführungen zur SupportsDisabledAttribute-Eigenschaft.
Hinweise
Diese Eigenschaft kann verwendet werden, um den Namen zu ändern, der für die DisabledCssClass Eigenschaft einzelner Websteuerelemente gerendert wird. Standardmäßig gibt diese Eigenschaft "aspNetDisabled" zurück.
Wenn SupportsDisabledAttribute in einer abgeleiteten Klasse, die zurückgegeben falsewerden soll, überschrieben wird, wird der Wert der DisabledCssClass Eigenschaft als Wert des Attributs class des HTML-Elements für das Steuerelement gerendert. Wenn in diesem Fall ein Wert in der CssClass Eigenschaft vorhanden ist, werden beide CSS-Klassen auf das gerenderte HTML-Element angewendet. Das class Attribut besteht aus dem Wert der DisabledCssClass Eigenschaft, gefolgt vom Wert der CssClass Eigenschaft, getrennt durch ein Leerzeichen.
Diese Eigenschaft ist statisch, was bedeutet, dass Sie sie nur für die WebControl Klasse festlegen können. Jeder Wert, auf den Sie ihn festlegen, wird für alle Steuerelemente in einer Webanwendung verwendet. Für einzelne Steuerelemente können keine unterschiedlichen Werte angegeben werden.
Wenn Sie einen Klassennamen verwenden möchten, der sich vom Standardwert von "aspNetDisabled" unterscheidet, legen Sie den Code in der Regel in die Application_Start Methode der Datei "Global.asax" ein, wie im folgenden Beispiel gezeigt:
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";
}
