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 wird, 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, set
Public Shared Property DisabledCssClass As String
Eigenschaftswert
Die CSS-Klasse, die auf das gerenderte HTML-Element angewendet werden soll, wenn das Steuerelement deaktiviert wird. Der Standardwert ist "aspNetDisabled".
Beispiele
Das folgende Beispiel zeigt gerenderter HTML-Code für ein deaktiviertes Label Steuerelement, wenn die SupportsDisabledAttribute Eigenschaft ist false
, wenn die DisabledCssClass Eigenschaft ihren Standardwert hat und wenn die CssClass Eigenschaft leer ist.
<span id="Label1" class="aspNetDisabled">Test</span>
Das folgende Beispiel zeigt gerendertes 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 zum Zurückgeben false
ü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. Der wert, auf den Sie ihn festlegen, wird für alle Steuerelemente in einer Webanwendung verwendet. Sie können keine unterschiedlichen Werte für einzelne Steuerelemente angeben.
Wenn Sie einen Klassennamen verwenden möchten, der sich vom Standardwert von "aspNetDisabled" unterscheidet, fügen Sie den Code dazu normalerweise 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";
}