Sert de classe de base qui définit les méthodes, propriétés et événements communs à l'ensemble des contrôles dans l'espace de noms
System.Web.UI.WebControls.
Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)
Visual Basic (Déclaration)
<ThemeableAttribute(True)> _
Public Class WebControl
Inherits Control
Implements IAttributeAccessor
Visual Basic (Utilisation)
Dim instance As WebControl
[ThemeableAttribute(true)]
public class WebControl : Control, IAttributeAccessor
[ThemeableAttribute(true)]
public ref class WebControl : public Control, IAttributeAccessor
/** @attribute ThemeableAttribute(true) */
public class WebControl extends Control implements IAttributeAccessor
ThemeableAttribute(true)
public class WebControl extends Control implements IAttributeAccessor
La classe WebControl fournit les propriétés, méthodes et événements communs à tous les contrôles serveur Web. Vous pouvez contrôler l'apparence et le comportement d'un contrôle serveur Web en définissant les propriétés définies dans cette classe. Par exemple, la couleur d'arrière-plan et la couleur de police d'un contrôle sont contrôlées en utilisant respectivement les propriétés BackColor et ForeColor. Pour les contrôles qui peuvent afficher une bordure, vous pouvez contrôler la largeur de bordure, le style de bordure et la couleur de bordure en définissant les propriétés BorderWidth, BorderStyle et BorderColor. La taille d'un contrôle serveur Web peut être spécifiée en utilisant les propriétés Height et Width.
Le comportement du contrôle peut être spécifié en définissant certaines propriétés. Vous pouvez activer et désactiver un contrôle en définissant la propriété Enabled. La position du contrôle dans l'ordre de tabulation est spécifiée en définissant la propriété TabIndex. Vous pouvez spécifier une info-bulle pour le contrôle en définissant la propriété ToolTip.
.gif) Remarque |
|---|
| Les contrôles ne prennent pas tous en charge l'ensemble des propriétés définies dans cette classe. Pour obtenir des informations sur la prise en charge d'une propriété particulière, consultez la documentation du contrôle spécifique. |
| Remarque |
|---|
| Certaines propriétés de cette classe effectuent un rendu différemment, suivant le navigateur. Certaines propriétés n'effectuent aucun rendu, tandis que d'autres effectuent un rendu, mais n'ont aucun effet. La propriété TagWriter de l'objet HttpBrowserCapabilities détermine comment un contrôle serveur Web est rendu. Pour les navigateurs qui prennent en charge HTML 4.0, la propriété TagWriter contient un objet HttpBrowserCapabilities normal et la plupart des propriétés sont rendues à l'aide d'attributs de style HTML 4.0. Les navigateurs qui ne prennent pas en charge HTML 4.0 utilisent l'objet Html32TextWriter. Cela met en correspondance automatiquement les attributs de style avec les attributs de balise HTML 3.2 appropriés. Dans certains cas, avec la propriété ForeColor, par exemple, les attributs de style sont convertis en balises supplémentaires, telles que des balises <font>. Dans certains cas, aucune mise en correspondance n'est effectuée. Pour obtenir des informations sur le rendu d'une propriété dans différents navigateurs, consultez la documentation de la propriété spécifique. |
Pour obtenir la liste des valeurs de propriétés initiales d'une instance de WebControl, consultez le constructeur WebControl.
Imports System
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace ControlTest
' Renders the following HTML:
' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
Public Class MyWebControl
Inherits WebControl
Public Sub New()
MyBase.New(HtmlTextWriterTag.Span)
End Sub 'New
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter)
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
MyBase.AddAttributesToRender(writer)
End Sub 'AddAttributesToRender
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub RenderContents(writer As HtmlTextWriter)
writer.Write("Custom Contents")
MyBase.RenderContents(writer)
End Sub 'RenderContents
End Class 'MyWebControl
End Namespace 'ControlTest
namespace ControlTest
{
using System;
using System.Web.UI;
using System.Web.UI.WebControls;
// Renders the following HTML:
// <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
public class MyWebControl: WebControl {
public MyWebControl() : base(HtmlTextWriterTag.Span)
{ }
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void AddAttributesToRender(HtmlTextWriter writer)
{
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
base.AddAttributesToRender(writer);
}
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void RenderContents(HtmlTextWriter writer)
{
writer.Write("Custom Contents");
base.RenderContents(writer);
}
}
}
package ControlTest;
import System.*;
import System.Web.UI.*;
import System.Web.UI.WebControls.*;
// Renders the following HTML:
// <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
public class MyWebControl extends WebControl
{
public MyWebControl()
{
super(HtmlTextWriterTag.Span);
} //MyWebControl
protected void AddAttributesToRender(HtmlTextWriter writer)
{
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
super.AddAttributesToRender(writer);
} //AddAttributesToRender
/** @attribute System.Security.Permissions.PermissionSet(System.Security.
Permissions.SecurityAction.Demand, Name = "FullTrust")
*/
protected void RenderContents(HtmlTextWriter writer)
{
writer.Write("Custom Contents");
super.RenderContents(writer);
} //RenderContents
} //MyWebControl
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
Classes dérivées
Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
.NET Framework
Prise en charge dans : 2.0, 1.1, 1.0