BaseValidator Classe
Définition
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.
Sert de classe de base abstraite pour les contrôles de validation.
public ref class BaseValidator abstract : System::Web::UI::WebControls::Label, System::Web::UI::IValidatorpublic abstract class BaseValidator : System.Web.UI.WebControls.Label, System.Web.UI.IValidatortype BaseValidator = class
inherit Label
interface IValidatorPublic MustInherit Class BaseValidator
Inherits Label
Implements IValidator- Héritage
- Dérivé
- Implémente
Exemples
L’exemple de code suivant montre comment utiliser plusieurs contrôles de validation pour vérifier que l’utilisateur entre une valeur valide dans un TextBox contrôle.
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.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
if (Page.IsValid)
{
MessageLabel.Text = "Page submitted successfully.";
}
else
{
MessageLabel.Text = "There is an error on the page.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Validator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Validator Example</h3>
Enter a number from 1 to 10.
<asp:textbox id="NumberTextBox"
runat="server"/>
<asp:rangevalidator id="NumberCompareValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
type="Integer"
display="Dynamic"
errormessage="Please enter a value from 1 to 10."
maximumvalue="10"
minimumvalue="1"
text="*"
runat="server"/>
<asp:requiredfieldvalidator id="TextBoxRequiredValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
display="Dynamic"
errormessage="Please enter a value."
text="*"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
onclick="Button_Click"
runat="server"/>
<br /><br />
<asp:label id="MessageLabel"
runat="server"/>
<br /><br />
<asp:validationsummary
id="ErrorSummary"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="False" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
If Page.IsValid Then
MessageLabel.Text = "Page submitted successfully."
Else
MessageLabel.Text = "There is an error on the page."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Validator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Validator Example</h3>
Enter a number from 1 to 10.
<asp:textbox id="NumberTextBox"
runat="server"/>
<asp:rangevalidator id="NumberCompareValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
type="Integer"
display="Dynamic"
errormessage="Please enter a value from 1 to 10."
maximumvalue="10"
minimumvalue="1"
text="*"
runat="server"/>
<asp:requiredfieldvalidator id="TextBoxRequiredValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
display="Dynamic"
errormessage="Please enter a value."
text="*"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
runat="server"/>
<br /><br />
<asp:label id="MessageLabel"
runat="server"/>
<br /><br />
<asp:validationsummary
id="ErrorSummary"
runat="server"/>
</form>
</body>
</html>
Remarques
La BaseValidator classe fournit l’implémentation principale pour tous les contrôles de validation. Les contrôles de validation sont utilisés pour valider l’entrée utilisateur dans un contrôle d’entrée associé. Lorsque l’utilisateur entre une valeur qui échoue à la validation, le contrôle de validation affiche un message d’erreur. Étant donné qu’un contrôle de validation est séparé du contrôle d’entrée, vous pouvez positionner le message d’erreur n’importe où sur la page par rapport au contrôle d’entrée. ASP.NET fournit plusieurs contrôles de validation qui effectuent des types spécifiques de validation. Le tableau suivant décrit ces contrôles.
| Contrôle de validation | Description |
|---|---|
| CompareValidator | Valide une valeur par rapport à la valeur entrée dans un autre contrôle d’entrée, par rapport à une valeur constante ou par rapport à un type de données approprié en définissant la CompareValidator.Operator propriété sur ValidationCompareOperator.DataTypeCheck. |
| CustomValidator | Valide une valeur à l’aide d’une routine de validation personnalisée fournie par l’utilisateur. |
| RangeValidator | Vérifie si une valeur se trouve dans une plage de valeurs. |
| RegularExpressionValidator | Valide une valeur à l’aide d’une expression régulière. |
| RequiredFieldValidator | Valide qu’une valeur a été entrée dans un champ obligatoire. |
Les contrôles de validation valident toujours le contrôle d’entrée associé sur le serveur. Les contrôles de validation ont également une implémentation côté client complète qui permet aux navigateurs compatibles avec les scripts (tels que Microsoft Internet Explorer version 4.0 et versions ultérieures) d’effectuer la validation sur le client. La validation côté client améliore le processus de validation en vérifiant l’entrée de l’utilisateur avant son envoi au serveur. Cela permet aux erreurs d’être détectées sur le client avant l’envoi du formulaire, ce qui évite l’aller-retour des informations nécessaires à la validation côté serveur.
Plusieurs contrôles de validation peuvent être utilisés avec un contrôle d’entrée individuel pour valider différents critères. Par exemple, vous pouvez appliquer plusieurs contrôles de validation sur un TextBox contrôle. Vous pouvez utiliser un RangeValidator contrôle pour vous assurer que la valeur entrée dans le TextBox contrôle se trouve dans une plage définie et un RequiredFieldValidator contrôle pour vous assurer que l’utilisateur entre une valeur.
ASP.NET fournit de nombreux contrôles qui ont la possibilité de publier sur le serveur. Quand l’un de ces contrôles a sa CausesValidation propriété définie truesur , la validation est effectuée lorsque le contrôle revient au serveur. Les contrôles suivants ont la possibilité de publier sur le serveur :
Note
Certains de ces contrôles sont renvoyés au serveur uniquement lorsque la AutoPostBack propriété est définie truesur .
Ces contrôles ont chacun une ValidationGroup propriété qui, quand elle est définie, valide uniquement les contrôles de validation au sein du groupe spécifié lorsque le contrôle déclenche une publication sur le serveur. Pour regrouper les contrôles de validation, définissez la ValidationGroup propriété de chaque contrôle de validation sur la même valeur.
Pour associer un contrôle d’entrée à un contrôle de validation, utilisez la ControlToValidate propriété. Pour spécifier le texte à afficher dans un contrôle de validation en cas d’échec de la validation, utilisez la Text propriété. Vous pouvez également afficher un résumé de tous les contrôles qui échouent à la validation dans la page à l’aide d’un ValidationSummary contrôle. Pour spécifier le texte à afficher dans un ValidationSummary contrôle, utilisez la ErrorMessage propriété.
Note
Si vous définissez la ErrorMessage propriété sans définir la Text propriété, la valeur de la ErrorMessage propriété est également affichée dans le contrôle de validation.
Lorsque vous utilisez des contrôles de validateur, vous devez toujours vérifier les résultats de la validation côté serveur avant d’effectuer un traitement. Après une publication, mais avant que vos méthodes d’événement ne soient appelées, la page appelle les contrôles de validateur et agrège leurs résultats dans la Page.IsValid propriété. (Vous pouvez également appeler les contrôles de validateur explicitement à l’aide de la Validate méthode.) Dans votre propre code, vous devez vérifier que la Page.IsValid propriété retourne true avant de traiter l’entrée. Même si les navigateurs avec script peuvent empêcher une publication sur le client si une vérification de validation a échoué, vous devez toujours vérifier Page.IsValid le code du serveur avant de traiter les données validées.
Vous pouvez également effectuer manuellement la validation. Pour valider tous les contrôles de validation sur la page, utilisez la Page.Validate méthode. Les contrôles de validation individuels peuvent être validés à l’aide de la Validate méthode du contrôle.
Note
Si vous utilisez la Page.IsValid propriété dans une Page_Load méthode, vous devez d’abord appeler explicitement la Page.Validate méthode. Étant donné que la validation se produit après l’événement Control.Load de la page, mais avant le gestionnaire d’événements pour les événements ou Command les Click événements, la Page.IsValid propriété n’est pas mise à jour tant que la Page.Validate méthode n’est pas appelée. En guise d’alternative, vous pouvez placer votre code dans le gestionnaire d’événements pour l’événement ou Command l’événement Click au lieu de la Page_Load méthode.
Tous les contrôles de serveur web ne prennent pas en charge les contrôles de validation. Les contrôles standard qui peuvent être validés avec un contrôle de validation sont les suivants :
Note
Pour qu’un contrôle d’entrée soit validé, l’attribut System.Web.UI.ValidationPropertyAttribute doit être appliqué au contrôle.
Note
Lorsque vous utilisez des contrôles de validateur qui dérivent de BaseValidator l’intérieur d’un UpdatePanel contrôle, assurez-vous que le contrôle validateur et le contrôle auquel il est associé se trouvent dans le même panneau. Pour plus d’informations sur l’utilisation du contrôle pour les UpdatePanel mises à jour partielles de page, consultez Partial-Page Vue d’ensemble du rendu.
Lorsque la validation échoue, vous pouvez définir le focus sur le contrôle d’entrée associé en définissant la SetFocusOnError propriété truesur .
Pour obtenir la liste des valeurs de propriété initiales d’une instance de BaseValidator, consultez le BaseValidator constructeur.
Accessibilité
Pour plus d’informations sur la configuration de ce contrôle afin qu’il génère des marques conformes aux normes d’accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et ASP.NET Contrôles et accessibilité.
Notes pour les responsables de l’implémentation
Lorsque vous héritez de la BaseValidator classe, vous devez remplacer le membre suivant : EvaluateIsValid().
Constructeurs
| Nom | Description |
|---|---|
| BaseValidator() |
Initialise une nouvelle instance de la classe BaseValidator. |
Propriétés
| Nom | Description |
|---|---|
| AccessKey |
Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web. (Hérité de WebControl) |
| Adapter |
Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control) |
| AssociatedControlID |
Cette propriété n’est pas prise en charge. |
| Attributes |
Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés du contrôle. (Hérité de WebControl) |
| BackColor |
Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web. (Hérité de WebControl) |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| BorderColor |
Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl) |
| BorderStyle |
Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl) |
| BorderWidth |
Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl) |
| ChildControlsCreated |
Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control) |
| ClientIDMode |
Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control) |
| Context |
Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control) |
| 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. (Hérité de Control) |
| ControlStyle |
Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ControlStyleCreated |
Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ControlToValidate |
Obtient ou définit le contrôle d’entrée à valider. |
| CssClass |
Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl) |
| DataItemContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| Display |
Obtient ou définit le comportement d’affichage du message d’erreur dans un contrôle de validation. |
| EnableClientScript |
Obtient ou définit une valeur indiquant si la validation côté client est activée. |
| Enabled |
Obtient ou définit une valeur qui indique si le contrôle de validation est activé. |
| EnableTheming |
Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de WebControl) |
| 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. (Hérité de Control) |
| ErrorMessage |
Obtient ou définit le texte du message d’erreur affiché dans un ValidationSummary contrôle en cas d’échec de la validation. |
| 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. (Hérité de Control) |
| Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
| ForeColor |
Obtient ou définit la couleur du message affiché lors de l’échec de la validation. |
| HasAttributes |
Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl) |
| 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. (Hérité de Control) |
| Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
| ID |
Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control) |
| IsEnabled |
Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl) |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control) |
| IsUnobtrusive |
Obtient une valeur qui indique si le contrôle génère un JavaScript discret. |
| IsValid |
Obtient ou définit une valeur qui indique si le contrôle d’entrée associé passe la validation. |
| IsViewStateEnabled |
Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control) |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control) |
| 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é. (Hérité de Control) |
| Page |
Obtient une référence à l’instance Page qui contient le contrôle serveur. (Hérité de Control) |
| Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page. (Hérité de Control) |
| PropertiesValid |
Obtient une valeur qui indique si le contrôle spécifié par la ControlToValidate propriété est un contrôle valide. |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| RenderUplevel |
Obtient une valeur qui indique si le navigateur du client prend en charge le rendu « à niveau supérieur ». |
| SetFocusOnError |
Obtient ou définit une valeur qui indique si le focus est défini sur le contrôle spécifié par la ControlToValidate propriété en cas d’échec de la validation. |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl) |
| Style |
Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du contrôle serveur Web. (Hérité de WebControl) |
| SupportsDisabledAttribute |
Obtient une valeur qui indique si le contrôle doit définir l’attribut |
| TabIndex |
Obtient ou définit l’index de tabulation du contrôle serveur Web. (Hérité de WebControl) |
| TagKey |
Obtient la balise HTML utilisée pour afficher le Label contrôle. (Hérité de Label) |
| TagName |
Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| TemplateControl |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
| TemplateSourceDirectory |
Obtient le répertoire virtuel du PageUserControl ou qui contient le contrôle serveur actuel. (Hérité de Control) |
| Text |
Obtient ou définit le texte affiché dans le contrôle de validation en cas d’échec de la validation. |
| Text |
Obtient ou définit le contenu texte du Label contrôle. (Hérité de Label) |
| ToolTip |
Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl) |
| UniqueID |
Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control) |
| 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. (Hérité de Control) |
| ValidationGroup |
Obtient ou définit le nom du groupe de validation auquel appartient ce contrôle de validation. |
| 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. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse. (Hérité de Control) |
| ViewStateMode |
Obtient ou définit le mode d’état d’affichage de ce contrôle. (Hérité de Control) |
| Visible |
Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control) |
| Width |
Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl) |
Méthodes
| Nom | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Ajoute les attributs HTML et les styles qui doivent être rendus pour le contrôle à l’objet spécifié HtmlTextWriter . |
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control . (Hérité de Control) |
| AddParsedSubObject(Object) |
Avertit le contrôle qu’un élément a été analysé et ajoute l’élément au Label contrôle. (Hérité de Label) |
| ApplyStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le suivi au moment du design des données de rendu. (Hérité de Control) |
| 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. (Hérité de Control) |
| CheckControlValidationProperty(String, String) |
Vérifie si le contrôle spécifié se trouve sur la page et contient des propriétés de validation. |
| ClearCachedClientID() |
Définit la valeur mise en ClientID cache sur |
| ClearChildControlState() |
Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildViewState() |
Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearEffectiveClientIDMode() |
Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control) |
| ControlPropertiesValid() |
Détermine si le contrôle spécifié par la ControlToValidate propriété est un contrôle valide. |
| CopyBaseAttributes(WebControl) |
Copie les propriétés non encapsulées par l’objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| 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. (Hérité de Control) |
| CreateControlCollection() |
Crée un ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control) |
| CreateControlStyle() |
Crée l’objet de style utilisé en interne par la WebControl classe pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control) |
| 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 . (Hérité de Control) |
| DataBindChildren() |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
| DetermineRenderUplevel() |
Détermine si le contrôle de validation peut effectuer une validation côté client. |
| Dispose() |
Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au suivi au moment du design des données de rendu. (Hérité de Control) |
| 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. (Hérité de Control) |
| EnsureID() |
Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| EvaluateIsValid() |
En cas de substitution dans une classe dérivée, cette méthode contient le code pour déterminer si la valeur du contrôle d’entrée est valide. |
| FindControl(String, Int32) |
Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| Focus() |
Définit le focus d’entrée sur un contrôle. (Hérité de Control) |
| GetControlRenderID(String) |
Obtient l’ID client du contrôle spécifié. |
| GetControlValidationValue(String) |
Obtient la valeur associée au contrôle d’entrée spécifié. |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| 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. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| 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é. (Hérité de Control) |
| GetValidationProperty(Object) |
Détermine la propriété de validation d’un contrôle (s’il existe). |
| HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control) |
| HasEvents() |
Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control) |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| 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. (Hérité de Control) |
| LoadViewState(Object) |
Charge l’état précédemment enregistré pour le contrôle. (Hérité de Label) |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MergeStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| 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. (Hérité de Control) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnInit(EventArgs) |
Déclenche l’événement Init. |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| 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. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| RegisterValidatorCommonScript() |
Inscrit le code sur la page pour la validation côté client. |
| RegisterValidatorDeclaration() |
Inscrit une déclaration de tableau ECMAScript à l’aide du nom |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control) |
| Render(HtmlTextWriter) |
Affiche le contrôle sur le client. |
| RenderBeginTag(HtmlTextWriter) |
Restitue la balise d’ouverture HTML du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| 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. (Hérité de Control) |
| RenderContents(HtmlTextWriter) |
Affiche le contenu de l’enregistreur Label spécifié. (Hérité de Label) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control) |
| 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é. (Hérité de Control) |
| RenderEndTag(HtmlTextWriter) |
Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ResolveAdapter() |
Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control) |
| ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control) |
| SaveControlState() |
Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre tout état modifié après l’appel de la TrackViewState() méthode. (Hérité de WebControl) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| 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. (Hérité de Control) |
| 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. (Hérité de Control) |
| 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. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| TrackViewState() |
Provoque le suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété de l’objet ViewState . (Hérité de WebControl) |
| Validate() |
Effectue la validation sur le contrôle d’entrée associé et met à jour la IsValid propriété. |
Événements
| Nom | Description |
|---|---|
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| 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. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control) |
| Load |
Se produit lorsque le contrôle serveur est chargé dans l’objet Page . (Hérité de Control) |
| PreRender |
Se produit après le chargement de l’objet Control , mais avant le rendu. (Hérité de Control) |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
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. |
