Cliquez pour évaluer et commenter
MSDN
MSDN Library
Développement .NET
Versions précédentes
.NET Framework SDK 2.0
Class Library Reference
System.Web.UI.WebControls
WebControl, classe

  Passer à l'affichage pour faible bande passante
Cette page est spécifique à
Microsoft Visual Studio 2005/.NET Framework 2.0

D'autres versions sont également disponibles pour :
Bibliothèque de classes .NET Framework
WebControl, classe

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
C#
[ThemeableAttribute(true)] 
public class WebControl : Control, IAttributeAccessor
C++
[ThemeableAttribute(true)] 
public ref class WebControl : public Control, IAttributeAccessor
J#
/** @attribute ThemeableAttribute(true) */ 
public class WebControl extends Control implements IAttributeAccessor
JScript
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.

RemarqueRemarque

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.

RemarqueRemarque

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.

Visual Basic
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

C#
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);
      }
   }
}

J#
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
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal
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
Contenu de la communauté   Qu'est-ce que le Contenu de la communauté ?
Ajouter du contenu RSS  Annotations
Processing
© 2009 Microsoft Corporation. Tous droits réservés. Conditions d'utilisation  |  Marques  |  Confidentialité
Page view tracker