Control, classe

Il s'agit de la classe principale de laquelle vous dérivez lorsque vous développez des contrôles serveur ASP.NET personnalisés. Control n'a pas de fonctionnalités spécifiques à l'interface utilisateur. Si vous créez un contrôle qui ne possède pas d'interface utilisateur ou qui combine d'autres contrôles qui définissent leur propre interface utilisateur, dérivez de Control. Si vous créez un contrôle qui possède une interface utilisateur, dérivez de WebControl ou de n'importe quel contrôle dans l'espace de noms System.Web.UI.WebControls qui fournit un point de début approprié pour votre contrôle personnalisé.

La classe Control est la classe de base pour tous les contrôles serveur ASP.NET, y compris les contrôles personnalisés, les contrôles utilisateur et les pages. Les pages ASP.NET sont des instances de la classe Page, qui hérite de la classe Control, et gèrent les demandes pour les fichiers ayant une extension .aspx.

La classe Control peut être utilisée directement ou indirectement dans le cadre de l'interface utilisateur pour votre application Web ; en tant que telle, vous devez l'examiner attentivement pour vous assurer que les meilleures pratiques en matière d'écriture de code sécurisé et de sécurisation d'applications sont appliquées.

Pour obtenir des informations générales sur ces rubriques, consultez Vue d'ensemble des menaces de sécurité des applications Web, Meilleures pratiques pour la stratégie de sécurité et Concepts fondamentaux sur la sécurité. Pour plus d'informations spécifiques, consultez Sécurisation de contrôles standard, Comment : afficher des messages d'erreur sécurisés, Comment : se protéger contre les attaques de script dans une application Web en utilisant l'encodage HTML et Introduction to the Validation Controls.

L'exemple suivant illustre un contrôle serveur personnalisé qui dérive de la classe Control. La classe InnerContent substitue la méthode Control.Render, vérifie si la classe possède des contrôles enfants sur la page et détermine si le premier enfant du contrôle est un contrôle littéral. Si ces deux conditions sont réunies, la méthode substituée écrit la chaîne HTML <H2>Your Message :, le contenu du contrôle littéral et une balise </H2> de fermeture sur la page Web Forms.

Note de sécurité
Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.

using System;
using System.Web;
using System.Web.UI;

namespace SimpleControlSamples {

    public class InnerContent : Control {
	[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")] 
       protected override void Render(HtmlTextWriter output) {

           if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
               output.Write("<H2>Your message : ");
               Controls[0].RenderControl(output);
               output.Write("</H2>");
           }
       }
    }    
}
   

.NET Framework

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources