WebControl.DisabledCssClass 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定當控制項停用時，要套用至所轉譯 HTML 項目的 CSS 類別。

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

屬性值

String

當控制項停用時，應該套用至所轉譯 HTML 項目的 CSS 類別。 預設值為 "aspNetDisabled"。

範例

下列範例顯示當 屬性為 時，已停用 Label 控制項的 HTML，當 DisabledCssClass 屬性具有其預設值時，以及當屬性是空的時 CssClass 。 SupportsDisabledAttributefalse

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

下列範例顯示相同情況下轉譯的 HTML，但 CssClass 屬性的值為 「SampleStyle」:

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

如需詳細資訊，請參閱 SupportsDisabledAttribute 屬性 (Property)。

備註

這個屬性可用來變更為 DisabledCssClass 個別 Web 控制項之 屬性呈現的名稱。 根據預設，此屬性會傳回 「aspNetDisabled」。

在衍生類別中覆寫以傳回 false 時 SupportsDisabledAttribute ，屬性的值 DisabledCssClass 會轉譯為 class 控制項之 HTML 元素的 屬性值。 在此情況下，如果 屬性中有 CssClass 值，這兩個 CSS 類別都會套用至轉譯的 HTML 元素。 屬性 class 會包含 屬性的值 DisabledCssClass ，後面接著以空格分隔的 CssClass 屬性值。

這個屬性是靜態的，這表示您只能針對 WebControl 類別設定它。 您設定為 的任何值都會用於 Web 應用程式中的所有控制項。 您無法為個別控制項指定不同的值。

如果您想要使用與預設值 「aspNetDisabled」 不同的類別名稱，您通常會將程式碼放在 Global.asax 檔案的 方法中 Application_Start ，如下列範例所示：

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

適用於

另請參閱