Control Classe

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit les propriétés, méthodes et événements partagés par tous les contrôles serveur ASP.NET.

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IParserAccessor

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IControlBuilderAccessor, System::Web::UI::IControlDesignerAccessor, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IExpressionsAccessor, System::Web::UI::IParserAccessor, System::Web::UI::IUrlResolutionService

public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IParserAccessor

[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IControlBuilderAccessor, System.Web.UI.IControlDesignerAccessor, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IExpressionsAccessor, System.Web.UI.IParserAccessor, System.Web.UI.IUrlResolutionService

type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IDataBindingsAccessor

[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IUrlResolutionService
    interface IDataBindingsAccessor
    interface IControlBuilderAccessor
    interface IControlDesignerAccessor
    interface IExpressionsAccessor

Public Class Control
Implements IComponent, IDataBindingsAccessor, IDisposable, IParserAccessor

Public Class Control
Implements IComponent, IControlBuilderAccessor, IControlDesignerAccessor, IDataBindingsAccessor, IDisposable, IExpressionsAccessor, IParserAccessor, IUrlResolutionService

Héritage: Object
Control

Dérivé: System.Web.DynamicData.DynamicControl

System.Web.DynamicData.DynamicDataManager

System.Web.DynamicData.DynamicEntity

System.Web.DynamicData.DynamicFilter

System.Web.DynamicData.EntityTemplate

Plus…

Attributs: BindableAttribute ThemeableAttribute

Implémente: IComponent IDisposable IDataBindingsAccessor IParserAccessor IControlBuilderAccessor IControlDesignerAccessor IExpressionsAccessor IUrlResolutionService

Exemples

L’exemple suivant illustre un contrôle serveur personnalisé qui dérive de la Control classe. La InnerContent classe remplace la Control.Render méthode, vérifie si la classe a 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 remplies, la méthode substituée écrit la chaîne <HTML H2>Your Message :, le contenu du contrôle littéral et une balise /H2> fermante <dans la page Web Forms.

Important

Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits 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>");
           }
       }
    }
}

Option Explicit
Option Strict

Imports System.Web
Imports System.Web.UI

Namespace SimpleControlSamples
    Public Class InnerContent
        Inherits Control
        <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
        Protected Overrides Sub Render(output As HtmlTextWriter)
            
            If HasControls() And TypeOf Controls(0) Is LiteralControl Then
                output.Write("<H2>Your message : ")
                Controls(0).RenderControl(output)
                output.Write("</H2>")
            End If
        End Sub
    End Class
End Namespace 'SimpleControlSamples

Remarques

Il s’agit de la classe principale à partir de laquelle vous dérivez lorsque vous développez des contrôles serveur ASP.NET personnalisés. Control n’a aucune fonctionnalité spécifique à l’interface utilisateur. Si vous créez un contrôle qui n’a pas d’interface utilisateur ou combine d’autres contrôles qui affichent leur propre interface utilisateur, dérivent de Control. Si vous créez un contrôle qui possède une interface utilisateur, dérivez ou n’importe quel contrôle de l’espace System.Web.UI.WebControls de WebControl noms qui fournit un point de départ 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. ASP.NET pages sont des instances de la classe Page, qui hérite de la classe Control, et qui gère les demandes de fichiers qui ont une extension .aspx.

La Control classe peut être utilisée directement ou indirectement dans le cadre de l’interface utilisateur de votre application web et, par conséquent, doit être examinée pour vous assurer que les meilleures pratiques pour écrire du code sécurisé et sécuriser des applications sont suivies.

Pour obtenir des informations générales sur ces rubriques, consultez Vue d’ensemble des menaces de sécurité des applications web, des meilleures pratiques de stratégie de sécurité et des concepts de sécurité clés. Pour plus d’informations, consultez Sécurisation des contrôles standard, Guide pratique pour afficher des messages d’erreur sécurisés, Comment : protéger contre les attaques de script dans une application web en appliquant l’encodage HTML aux chaînes et présentation des contrôles de validation.

Constructeurs

Nom	Description
Control()	Initialise une nouvelle instance de la classe Control.

Propriétés

Nom	Description
Adapter	Obtient l’adaptateur spécifique au navigateur pour le contrôle.
AppRelativeTemplateSourceDirectory	Obtient ou définit le répertoire virtuel relatif à l’application du ou Page de l’objet UserControl qui contient ce contrôle.
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle.
ChildControlsCreated	Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés.
ClientID	Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET.
ClientIDMode	Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété.
ClientIDSeparator	Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété.
Context	Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle.
Controls	Obtient un ControlCollection objet qui représente les contrôles enfants d’un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur.
DataItemContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente .
DataKeysContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente .
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception.
EnableTheming	Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle.
EnableViewState	Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur.
Events	Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule.
HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés.
ID	Obtient ou définit l’identificateur programmatique affecté au contrôle serveur.
IdSeparator	Obtient le caractère utilisé pour séparer les identificateurs de contrôle.
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle.
IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage.
IsViewStateEnabled	Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle.
LoadViewStateByID	Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index.
NamingContainer	Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété.
Page	Obtient une référence à l’instance Page qui contient le contrôle serveur.
Parent	Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page.
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible.
Site	Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception.
SkinID	Obtient ou définit la peau à appliquer au contrôle.
TemplateControl	Obtient ou définit une référence au modèle qui contient ce contrôle.
TemplateSourceDirectory	Obtient le répertoire virtuel du Page UserControl ou qui contient le contrôle serveur actuel.
UniqueID	Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur.
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses.
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un contrôle serveur sur plusieurs requêtes pour la même page.
ViewStateIgnoresCase	Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse.
ViewStateMode	Obtient ou définit le mode d’état d’affichage de ce contrôle.
Visible	Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page.

Méthodes

Nom	Description
AddedControl(Control, Int32)	Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control .
AddParsedSubObject(Object)	Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur.
ApplyStyleSheetSkin(Page)	Applique les propriétés de style définies dans la feuille de style de page au contrôle.
BeginRenderTracing(TextWriter, Object)	Commence le suivi au moment du design des données de rendu.
BuildProfileTree(String, Boolean)	Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page.
ClearCachedClientID()	Définit la valeur mise en ClientID cache sur `null`.
ClearChildControlState()	Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.
ClearChildState()	Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur.
ClearChildViewState()	Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur.
ClearEffectiveClientIDMode()	Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit.
CreateChildControls()	Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu.
CreateControlCollection()	Crée un ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur.
DataBind()	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.
DataBind(Boolean)	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option pour déclencher l’événement DataBinding .
DataBindChildren()	Lie une source de données aux contrôles enfants du contrôle serveur.
Dispose()	Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire.
EndRenderTracing(TextWriter, Object)	Met fin au suivi au moment du design des données de rendu.
EnsureChildControls()	Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants.
EnsureID()	Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindControl(String, Int32)	Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié `id` et spécifié dans le `pathOffset` paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode.
FindControl(String)	Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié `id` .
Focus()	Définit le focus d’entrée sur un contrôle.
GetDesignModeState()	Obtient les données au moment du design pour un contrôle.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetRouteUrl(Object)	Obtient l’URL qui correspond à un ensemble de paramètres de routage.
GetRouteUrl(RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres de routage.
GetRouteUrl(String, Object)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire.
GetRouteUrl(String, RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié.
HasControls()	Détermine si le contrôle serveur contient des contrôles enfants.
HasEvents()	Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants.
IsLiteralContent()	Détermine si le contrôle serveur contient uniquement du contenu littéral.
LoadControlState(Object)	Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode.
LoadViewState(Object)	Restaure les informations d’état d’affichage à partir d’une demande de page précédente enregistrée par la SaveViewState() méthode.
MapPathSecure(String)	Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnBubbleEvent(Object, EventArgs)	Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page.
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding.
OnInit(EventArgs)	Déclenche l’événement Init.
OnLoad(EventArgs)	Déclenche l’événement Load.
OnPreRender(EventArgs)	Déclenche l’événement PreRender.
OnUnload(EventArgs)	Déclenche l’événement Unload.
OpenFile(String)	Obtient un Stream élément utilisé pour lire un fichier.
RaiseBubbleEvent(Object, EventArgs)	Affecte toutes les sources de l’événement et ses informations au parent du contrôle.
RemovedControl(Control)	Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control .
Render(HtmlTextWriter)	Envoie le contenu du contrôle serveur à un objet fourni HtmlTextWriter , qui écrit le contenu à afficher sur le client.
RenderChildren(HtmlTextWriter)	Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client.
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter .
RenderControl(HtmlTextWriter)	Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé.
ResolveAdapter()	Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié.
ResolveClientUrl(String)	Obtient une URL qui peut être utilisée par le navigateur.
ResolveUrl(String)	Convertit une URL en une URL utilisable sur le client demandeur.
SaveControlState()	Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur.
SaveViewState()	Enregistre les modifications de l’état d’affichage du contrôle de serveur qui se sont produites depuis la publication de la page sur le serveur.
SetDesignModeState(IDictionary)	Définit les données au moment du design pour un contrôle.
SetRenderMethodDelegate(RenderMethod)	Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent.
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace.
SetTraceData(Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TrackViewState()	Provoque le suivi des modifications d’état d’affichage apportées au contrôle serveur afin qu’ils puissent être stockés dans l’objet du StateBag contrôle serveur. Cet objet est accessible via la ViewState propriété.

Événements

Nom	Description
DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données.
Disposed	Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée.
Init	Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie.
Load	Se produit lorsque le contrôle serveur est chargé dans l’objet Page .
PreRender	Se produit après le chargement de l’objet Control , mais avant le rendu.
Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire.

Implémentations d’interfaces explicites

Nom	Description
IControlBuilderAccessor.ControlBuilder	Pour obtenir une description de ce membre, consultez ControlBuilder.
IControlDesignerAccessor.GetDesignModeState()	Pour obtenir une description de ce membre, consultez GetDesignModeState().
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).
IControlDesignerAccessor.SetOwnerControl(Control)	Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).
IControlDesignerAccessor.UserData	Pour obtenir une description de ce membre, consultez UserData.
IDataBindingsAccessor.DataBindings	Pour obtenir une description de ce membre, consultez DataBindings.
IDataBindingsAccessor.HasDataBindings	Pour obtenir une description de ce membre, consultez HasDataBindings.
IExpressionsAccessor.Expressions	Pour obtenir une description de ce membre, consultez Expressions.
IExpressionsAccessor.HasExpressions	Pour obtenir une description de ce membre, consultez HasExpressions.
IParserAccessor.AddParsedSubObject(Object)	Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).

Méthodes d’extension

Nom	Description
FindDataSourceControl(Control)	Retourne la source de données associée au contrôle de données pour le contrôle spécifié.
FindFieldTemplate(Control, String)	Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.
FindMetaTable(Control)	Retourne l’objet métatable pour le contrôle de données contenant.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?