Exporter (0) Imprimer
Développer tout

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)

[ThemeableAttribute(true)] 
public class WebControl : 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.

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.

RubriqueEmplacement
Procédure pas à pas : création d'un Concepteur de contrôles de base pour un contrôle serveur Web ASP.NETCréation de contrôles ASP.NET
Procédure pas à pas : développement et utilisation d'un contrôle serveur personnaliséCréation de contrôles ASP.NET
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 1.1Création de contrôles ASP.NET
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 1.1Création de contrôles ASP.NET
Procédure pas à pas : développement et utilisation d'un contrôle serveur personnaliséGénération d'applications à l'aide de Visual Web Developer
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 1.1Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un Concepteur de contrôles de base pour un contrôle serveur WebGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir les propriétés de style d'un contrôle serveur ASP.NET à l'aide de la syntaxe ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 1.1Génération d'applications Web ASP.NET dans Visual Studio
Comment : définir les propriétés de style d'un contrôle serveur ASP.NET à l'aide de la syntaxe ASP.NETGénération d'applications Web ASP.NET
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 1.1Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un Concepteur de contrôles de base pour un contrôle serveur WebGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 1.1Génération d'applications Web ASP.NET dans Visual Studio
Comment : définir les propriétés de style d'un contrôle serveur ASP.NET à l'aide de la syntaxe ASP.NETGénération d'applications Web ASP.NET dans Visual Studio

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

  • 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

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft