WebControl.DisabledCssClass Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

String

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

Gilt für:

Weitere Informationen