WebControl.SupportsDisabledAttribute Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement het disabled kenmerk van het gerenderde HTML-element moet instellen op 'uitgeschakeld' wanneer de eigenschap van IsEnabled het besturingselement is false.
public:
virtual property bool SupportsDisabledAttribute { bool get(); };[System.ComponentModel.Browsable(false)]
public virtual bool SupportsDisabledAttribute { get; }[<System.ComponentModel.Browsable(false)>]
member this.SupportsDisabledAttribute : boolPublic Overridable ReadOnly Property SupportsDisabledAttribute As BooleanWaarde van eigenschap
Altijd true.
- Kenmerken
Voorbeelden
In het volgende voorbeeld ziet u markeringen voor een uitgeschakeld besturingselement Label :
<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>
In ASP.NET 3.5 en eerdere versies wordt met deze markering de volgende HTML weergegeven:
<span id="Label1" disabled="disabled">Test</span>
Als in ASP.NET 4 de waarde van de eigenschap RenderingCompatibility 4,0 of hoger is en als de eigenschap DisabledCssClass is ingesteld op de standaardwaarde, wordt de volgende HTML weergegeven:
<span id="Label1" class="aspNetDisabled">Test</span>
Opmerkingen
In afgeleide klassen geeft deze eigenschap aan hoe ASP.NET HTML moet weergeven voor een besturingselement wanneer het besturingselement is uitgeschakeld.
ASP.NET webbesturingselementen uitschakelen
Wanneer de eigenschap Enabled van een ASP.NET besturingselement is ingesteld op false (dat wil gezegd, wanneer het besturingselement is uitgeschakeld), is de bedoeling dat ASP.NET het besturingselement op de pagina moet weergeven, maar het in een uitgeschakelde status moet weergeven (meestal grijs). Als een bovenliggend besturingselement is uitgeschakeld, worden onderliggende elementen van dat besturingselement ook weergegeven als uitgeschakeld. In dat geval is de eigenschap van IsEnabled het onderliggende besturingselement ingesteld op false, ook al is de Enabled eigenschap ervan mogelijk ingesteld op true.
Wanneer in ASP.NET 3.5 en eerdere versies de eigenschap IsEnabled van een besturingselement false is, stelt ASP.NET het kenmerk disabled in op 'uitgeschakeld' in het HTML-element dat voor het besturingselement wordt weergegeven. Met de HTML 4.01-standaard is het disabled kenmerk echter alleen toegestaan voor bepaalde elementen die worden gebruikt voor gebruikersinvoer. Het kenmerk is bijvoorbeeld disabled toegestaan voor input elementen, maar niet voor span elementen.
De meeste browsers ondersteunen een standaard uitgeschakeld uiterlijk voor alleen-weergeven elementen met disabled kenmerken. Als u echter wilt voldoen aan HTML-standaarden, worden standaard ASP.NET 4 ongeldige kenmerken weggelaten.
Hoe de eigenschap SupportsDisabledAttribute wordt gebruikt
Als de eigenschap SupportsDisabledAttribute is true, geeft ASP.NET een kenmerk disabled weer wanneer het besturingselement is uitgeschakeld. Als deze eigenschap false is, geeft ASP.NET een kenmerk class weer wanneer het besturingselement is uitgeschakeld.
Afgeleide klassen overschrijven deze eigenschap om te retourneren false als aan alle volgende voorwaarden wordt voldaan:
Het besturingselement geeft een HTML-element weer dat het
disabledkenmerk niet ondersteunt.De eigenschap RenderingCompatibility geeft een ASP.NET versienummer lager dan 4.0 aan.
De SupportsDisabledAttribute eigenschap geeft niet noodzakelijkerwijs aan of het HTML-element dat voor een besturingselement wordt weergegeven, het disabled kenmerk ondersteunt (toestaat). Als de eigenschap RenderingCompatibility van een besturingselement een ASP.NET versienummer lager dan 4.0 aangeeft, kan de waarde van de eigenschap SupportsDisabledAttribute van het besturingselement true retourneren, zelfs als de weergegeven HTML het kenmerk disabled niet ondersteunt.
Compatibiliteit met eerdere versies voor uitgeschakelde besturingselementen
Wanneer u Visual Studio gebruikt om een webproject bij te werken naar ASP.NET 4 van een eerdere versie, stelt Visual Studio automatisch het kenmerk controlRenderingCompatibilityVersion in het bestand Web.config (waarmee de eigenschap RenderingCompatibility) wordt ingesteld op het eerdere versienummer. Omdat de SupportsDisabledAttribute eigenschap altijd wordt geretourneerd true wanneer de RenderingCompatibility eigenschap lager is dan 4.0, zorgt dit ervoor dat webbesturingselementen HTML weergeven voor uitgeschakelde besturingselementen zoals in de eerdere versie. Als u wilt dat een bijgewerkte website HTML weergeeft met behulp van het algoritme dat is geïntroduceerd in ASP.NET 4, kunt u het kenmerk controlRenderingCompatibilityVersion wijzigen of verwijderen. Voor meer informatie, zie de eigenschap RenderingCompatibility.
Een uitgeschakeld uiterlijk instellen met behulp van CSS
Als de eigenschap SupportsDisabledAttribute van een besturingselement is false en het besturingselement is uitgeschakeld, stelt ASP.NET het kenmerk class van het gerenderde HTML-element in op de waarde van de eigenschap WebControl.DisabledCssClass. De standaardwaarde van de WebControl.DisabledCssClass eigenschap is 'aspNetDisabled'.
Als u een uitgeschakeld uiterlijk wilt opgeven voor uitgeschakelde besturingselementen, moet u een CSS-regel definiëren voor de klasse die wordt vertegenwoordigd door de waarde van de WebControl.DisabledCssClass eigenschap.
Het HTML-element dat voor een besturingselement wordt weergegeven, heeft mogelijk meer dan één waarde in het class kenmerk als de eigenschap een waarde CssClass bevat. Voor meer informatie, zie de eigenschap DisabledCssClass.
