WebControl.SupportsDisabledAttribute Proprietà

Definizione

Ottiene un valore che indica se il controllo deve impostare l'attributo disabled dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è false.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

Valore della proprietà

Sempre true.Always true.

Attributi

Esempi

Nell'esempio seguente viene illustrato il markup per Label un controllo disabilitato:The following example shows markup for a disabled Label control:

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

In ASP.NET 3,5 e versioni precedenti, questo markup esegue il rendering del codice HTML seguente:In ASP.NET 3.5 and earlier versions, this markup renders the following HTML:

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

In ASP.NET 4, se il valore della RenderingCompatibility proprietà è 4,0 o superiore e se la DisabledCssClass proprietà è impostata sul valore predefinito, lo stesso markup esegue il rendering del codice HTML seguente: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>

Commenti

Nelle classi derivate questa proprietà indica il modo in cui ASP.NET deve eseguire il rendering del codice HTML per un controllo quando il controllo è disabilitato.In derived classes, this property indicates how ASP.NET should render HTML for a control when the control is disabled.

Disabilitazione di controlli Web ASP.NETDisabling ASP.NET Web Controls

Quando la Enabled proprietà di un controllo ASP.NET è impostata su false (ovvero, quando il controllo è disabilitato), l'intento è che ASP.NET deve eseguire il rendering del controllo nella pagina, ma lo Visualizza in uno stato disabilitato (in genere in grigio).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). Se un controllo padre è disabilitato, anche gli elementi figlio di tale controllo vengono visualizzati come disabilitati.If a parent control is disabled, children of that control are also displayed as disabled. In tal caso, IsEnabled la proprietà del controllo figlio è impostata su false, anche se la relativa Enabled proprietà potrebbe essere impostata truesu.In that case, the child control's IsEnabled property is set to false, even though its Enabled property might be set to true.

In ASP.NET 3,5 e versioni precedenti, quando la IsEnabled proprietà di un controllo è false, ASP.NET imposta disabled l'attributo su "disabled" nell'elemento HTML di cui viene eseguito il rendering per il controllo.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. Tuttavia, lo standard HTML 4,01 consente l' disabled attributo solo su determinati elementi utilizzati per l'input dell'utente.However, the HTML 4.01 standard allows the disabled attribute only on certain elements that are used for user input. Ad esempio, l' disabled attributo è consentito per input gli elementi, ma non span per gli elementi.For example, the disabled attribute is allowed for input elements, but not for span elements.

La maggior parte dei browser supporta un aspetto disabilitato predefinito per gli elementi disabled di sola visualizzazione con attributi.Most browsers support a default disabled appearance for display-only elements that have disabled attributes. Tuttavia, per garantire la conformità con gli standard HTML, per impostazione predefinita ASP.NET 4 omette gli attributi non validi.However, in order to comply with HTML standards, by default ASP.NET 4 omits invalid attributes.

Modalità di utilizzo della proprietà SupportsDisabledAttributeHow the SupportsDisabledAttribute Property is Used

Se la SupportsDisabledAttribute proprietà è true, ASP.NET esegue il rendering disabled di un attributo quando il controllo è disabilitato.If the SupportsDisabledAttribute property is true, ASP.NET renders a disabled attribute when the control is disabled. Se questa proprietà è false, ASP.NET esegue il rendering class di un attributo quando il controllo è disabilitato.If this property is false, ASP.NET renders a class attribute when the control is disabled.

Le classi derivate eseguono l' false override di questa proprietà per restituire se si verificano tutte le condizioni seguenti:Derived classes override this property to return false if all the following conditions are true:

  • Il controllo esegue il rendering di un elemento HTML che non supporta disabled l'attributo.The control renders an HTML element that does not support the disabled attribute.

  • La RenderingCompatibility proprietà indica un numero di versione di ASP.NET inferiore a 4,0.The RenderingCompatibility property indicates an ASP.NET version number lower than 4.0.

La SupportsDisabledAttribute proprietà non indica necessariamente se l'elemento HTML di cui è stato eseguito il rendering per un controllo supporta ( disabled consente) l'attributo.The SupportsDisabledAttribute property does not necessarily indicate whether the HTML element that is rendered for a control supports (allows) the disabled attribute. Se la RenderingCompatibility proprietà di un controllo indica un numero di versione di ASP.NET inferiore a 4,0, il valore della SupportsDisabledAttribute proprietà del controllo true potrebbe restituire anche se il codice HTML sottoposto disabled a rendering non supporta l'attributo.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.

Compatibilità con le versioni precedenti per i controlli disabilitatiBackward Compatibility for Disabled Controls

Quando si usa Visual Studio per aggiornare un progetto Web a ASP.NET 4 da una versione precedente, Visual Studio imposta automaticamente l' controlRenderingCompatibilityVersion attributo nel file Web. config (che imposta la RenderingCompatibility proprietà) sul numero di versione precedente.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. Poiché la SupportsDisabledAttribute proprietà restituisce true sempre quando la RenderingCompatibility proprietà è inferiore a 4,0, i controlli Web eseguono il rendering del codice HTML per i controlli disabilitati come nella versione precedente.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. Se si desidera che un sito Web aggiornato esegua il rendering del codice HTML utilizzando l'algoritmo introdotto in ASP.NET 4, è controlRenderingCompatibilityVersion possibile modificare o rimuovere l'attributo.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. Per altre informazioni, vedere la proprietà RenderingCompatibility.For more information, see the RenderingCompatibility property.

Impostazione di un aspetto disabilitato tramite CSSSetting a Disabled Appearance By Using CSS

Se la SupportsDisabledAttribute proprietà di un controllo è false e il controllo è disabilitato, ASP.NET imposta class l'attributo dell'elemento HTML sottoposto a WebControl.DisabledCssClass rendering sul valore della proprietà.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. Il valore predefinito della WebControl.DisabledCssClass proprietà è "aspNetDisabled".The default value of the WebControl.DisabledCssClass property is "aspNetDisabled".

Per fornire un aspetto disabilitato per i controlli disabilitati, è necessario definire una regola CSS per la classe rappresentata dal valore della WebControl.DisabledCssClass proprietà.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.

L'elemento HTML di cui è stato eseguito il rendering per un controllo potrebbe avere più di class un valore nel relativo attributo se è presente CssClass un valore nella relativa proprietà.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. Per altre informazioni, vedere la proprietà DisabledCssClass.For more information, see the DisabledCssClass property.

Si applica a

Vedi anche