WebControl.SupportsDisabledAttribute WebControl.SupportsDisabledAttribute WebControl.SupportsDisabledAttribute WebControl.SupportsDisabledAttribute Property

定義

コントロールの IsEnabled プロパティが false の場合、レンダリングされた HTML 要素の disabled 属性を "無効" に設定するかどうかを示す値を取得します。Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

public:
 virtual property bool SupportsDisabledAttribute { bool get(); };
[System.ComponentModel.Browsable(false)]
public virtual bool SupportsDisabledAttribute { get; }
member this.SupportsDisabledAttribute : bool
Public Overridable ReadOnly Property SupportsDisabledAttribute As Boolean

プロパティ値

常に trueAlways true.

次の例では、マークアップを示しますの無効なLabelコントロール。The following example shows markup for a disabled Label control:

<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>

ASP.NET 3.5 およびそれ以前のバージョンでは、このマークアップは、次の HTML を表示します。In ASP.NET 3.5 and earlier versions, this markup renders the following HTML:

<span id="Label1" disabled="disabled">Test</span>

ASP.NET 4 の場合の値、RenderingCompatibilityプロパティは 4.0 以降、場合に、DisabledCssClassの既定値に設定されて、同じマークアップは、次の HTML を表示します。In ASP.NET 4, if the value of the RenderingCompatibility property is 4.0 or greater, and if the DisabledCssClass property is set to its default value, the same markup renders the following HTML:

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

注釈

派生クラスでは、このプロパティは、コントロールが無効になっているときに ASP.NET がそのコントロールの HTML をどのように描画するかを示します。In derived classes, this property indicates how ASP.NET should render HTML for a control when the control is disabled.

無効にする ASP.NET Web コントロールします。Disabling ASP.NET Web Controls

ときに、 Enabled ASP.NET コントロールのプロパティに設定されてfalse(つまり、コントロールが無効にした場合)、目的は、ASP.NET がページで、コントロールの表示が無効な状態 (通常は淡色表示) に表示する必要があります。When the Enabled property of an ASP.NET control is set to false (that is, when the control is disabled), the intent is that ASP.NET should render the control in the page, but display it in a disabled state (typically dimmed). 親コントロールが無効になっているもにはそのコントロールの子は、無効になっているように表示されます。If a parent control is disabled, children of that control are also displayed as disabled. その場合、子コントロールのIsEnabledプロパティに設定されてfalse場合でも、そのEnabledプロパティを設定するtrueします。In that case, the child control's IsEnabled property is set to false, even though its Enabled property might be set to true.

ASP.NET 3.5 および以前のバージョン、ときに、コントロールのIsEnabledプロパティはfalse、ASP.NET のセット、disabledコントロールをレンダリングする HTML 要素の属性を"disabled"。In ASP.NET 3.5 and earlier versions, when a control's IsEnabled property is false, ASP.NET sets the disabled attribute to "disabled" in the HTML element that it renders for the control. ただし、HTML 4.01 標準では、disabledのみユーザー入力に使用される特定の要素の属性。However, the HTML 4.01 standard allows the disabled attribute only on certain elements that are used for user input. たとえば、disabled属性は許可されてinput要素ではなくspan要素。For example, the disabled attribute is allowed for input elements, but not for span elements.

ほとんどのブラウザーでは、無効になっている既定の外観をサポートされている表示のみの要素にdisabled属性。Most browsers support a default disabled appearance for display-only elements that have disabled attributes. ただし、HTML 標準に準拠して、ASP.NET 4 を既定では、無効な属性を省略します。However, in order to comply with HTML standards, by default ASP.NET 4 omits invalid attributes.

SupportsDisabledAttribute プロパティの使用方法How the SupportsDisabledAttribute Property is Used

場合、SupportsDisabledAttributeプロパティはtrue、ASP.NET のレンダリングをdisabledコントロールを無効にする属性します。If the SupportsDisabledAttribute property is true, ASP.NET renders a disabled attribute when the control is disabled. 場合、このプロパティはfalse、ASP.NET のレンダリングをclassコントロールを無効にする属性します。If this property is false, ASP.NET renders a class attribute when the control is disabled.

派生クラスを返すには、このプロパティをオーバーライドするfalse次の条件に該当する場合。Derived classes override this property to return false if all the following conditions are true:

  • コントロールがサポートされていない HTML 要素を表示する、disabled属性。The control renders an HTML element that does not support the disabled attribute.

  • RenderingCompatibilityプロパティ 4.0 より前の ASP.NET バージョン番号を示します。The RenderingCompatibility property indicates an ASP.NET version number lower than 4.0.

SupportsDisabledAttributeプロパティは必ずしもコントロールに表示される HTML 要素をサポートしているかどうか (許可)、disabled属性。The SupportsDisabledAttribute property does not necessarily indicate whether the HTML element that is rendered for a control supports (allows) the disabled attribute. コントロールの場合RenderingCompatibilityプロパティ 4.0 では、コントロールの値よりも低い ASP.NET バージョン番号を示しますSupportsDisabledAttributeプロパティが返す可能性がありますtrueレンダリングされる HTML がサポートしていない場合でも、disabled属性。If a control's RenderingCompatibility property indicates an ASP.NET version number lower than 4.0, the value of the control's SupportsDisabledAttribute property might return true even if the rendered HTML does not support the disabled attribute.

無効なコントロールとの下位互換性Backward Compatibility for Disabled Controls

Visual Studio を使用して Web プロジェクトを ASP.NET 4 を以前のバージョンからアップグレードすると、Visual Studio は自動的に設定、 controlRenderingCompatibilityVersion Web.config ファイル内の属性 (どのセット、RenderingCompatibilityプロパティ) 以前のバージョン番号にします。When you use Visual Studio to upgrade a Web project to ASP.NET 4 from an earlier version, Visual Studio automatically sets the controlRenderingCompatibilityVersion attribute in the Web.config file (which sets the RenderingCompatibility property) to the earlier version number. SupportsDisabledAttributeプロパティは常に返しますtrueときに、RenderingCompatibilityプロパティが 4.0 よりも低い場合、これが原因で、以前のバージョンと同様に、無効になっているコントロールの HTML を表示する Web コントロール。Because the SupportsDisabledAttribute property always returns true when the RenderingCompatibility property is lower than 4.0, this causes Web controls to render HTML for disabled controls as they did in the earlier version. ASP.NET 4 で導入されたアルゴリズムを使用して HTML を表示するために、アップグレード済みの Web サイトを設定する場合は、変更または削除、controlRenderingCompatibilityVersion属性。If you want an upgraded Web site to render HTML using the algorithm introduced in ASP.NET 4, you can change or remove the controlRenderingCompatibilityVersion attribute. 詳細については、RenderingCompatibility プロパティを参照してください。For more information, see the RenderingCompatibility property.

CSS を使用して無効な外観を設定します。Setting a Disabled Appearance By Using CSS

場合、SupportsDisabledAttributeコントロールのプロパティがfalse、コントロールが無効になっている、ASP.NET のセット、classの値にレンダリングされた HTML 要素の属性、WebControl.DisabledCssClassプロパティ。If the SupportsDisabledAttribute property of a control is false and the control is disabled, ASP.NET sets the class attribute of the rendered HTML element to the value of the WebControl.DisabledCssClass property. 既定値、WebControl.DisabledCssClassプロパティは"aspNetDisabled"です。The default value of the WebControl.DisabledCssClass property is "aspNetDisabled".

無効になっているコントロールの無効な外観を提供するには、値によって表されるクラスの CSS 規則を定義する必要があります、WebControl.DisabledCssClassプロパティ。To provide a disabled appearance for disabled controls, you must define a CSS rule for the class that is represented by the value of the WebControl.DisabledCssClass property.

コントロール 1 つ以上の値を持つ可能性がありますについてレンダリングされる HTML 要素のclass属性の値がある場合、CssClassプロパティ。The HTML element that is rendered for a control might have more than one value in its class attribute if there is a value in its CssClass property. 詳細については、DisabledCssClass プロパティを参照してください。For more information, see the DisabledCssClass property.

適用対象

こちらもご覧ください