UserControl 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.
Représente un fichier .ascx, également appelé contrôle utilisateur, demandé à partir d’un serveur qui héberge une application web ASP.NET. Le fichier doit être appelé à partir d’une page Web Forms ou une erreur d’analyseur se produit.
public ref class UserControl : System::Web::UI::TemplateControl, System::Web::UI::IAttributeAccessor, System::Web::UI::IUserControlDesignerAccessor
public class UserControl : System.Web.UI.TemplateControl, System.Web.UI.IAttributeAccessor, System.Web.UI.IUserControlDesignerAccessor
type UserControl = class
inherit TemplateControl
interface IAttributeAccessor
interface IUserControlDesignerAccessor
type UserControl = class
inherit TemplateControl
interface IAttributeAccessor
interface INamingContainer
interface IUserControlDesignerAccessor
Public Class UserControl
Inherits TemplateControl
Implements IAttributeAccessor, IUserControlDesignerAccessor
- Héritage
- Dérivé
- Implémente
Exemples
La classe définie dans l’exemple suivant, SimpleControlhérite de la UserControl classe et peut être utilisée comme classe code-behind ASP.NET. Il utilise les TextBoxcontrôles , Labelet serveur Web et Button définit une myButton_Click méthode qui affecte la valeur de propriété TextBox.Text , ainsi que deux chaînes, à la Label.Text propriété.
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.UI;
using System.Web.UI.WebControls;
public class SimpleControl:UserControl
{
public TextBox name;
public Label output;
public Button myButton;
public void myButton_Click(object sender, EventArgs e)
{
output.Text = "Hello, " + name.Text + ".";
}
}
Imports System.Web.UI
Imports System.Web.UI.WebControls
Public Class SimpleControl
Inherits UserControl
Public name As TextBox
Public output As Label
Public myButton As Button
Public Sub myButton_Click(sender As Object, e As EventArgs)
output.Text = "Hello, " + name.Text + "."
End Sub
End Class
L’exemple suivant est le balisage contenu dans un fichier .ascx. Vous pouvez utiliser la SimpleControl classe définie dans l’exemple précédent comme classe code-behind pour le balisage dans ce fichier .ascx.
<%@ control inherits = "SimpleControl" src = "SimpleControl.cs" %>
<table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>
<%@ control inherits = "SimpleControl" src = "SimpleControl.vb" %>
<table style="background-color: yellow; font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>
Remarques
La UserControl classe est associée aux fichiers qui ont des extensions .ascx. Ces fichiers sont compilés au moment de l’exécution en tant qu’objets UserControl et mis en cache dans la mémoire du serveur.
Vous pouvez imbriquer les contrôles utilisateur en déclarant un fichier .ascx dans un autre, y compris celui-ci dans une page Web Forms.
Les contrôles utilisateur sont contenus dans ASP.NET pages Web Forms et offrent aux développeurs web un moyen simple de capturer l’interface utilisateur web couramment utilisée. Ils sont instanciés et mis en cache de manière similaire aux Page objets. Contrairement aux pages, toutefois, les contrôles utilisateur ne peuvent pas être appelés indépendamment. Ils ne peuvent être appelés qu’à partir de la page ou d’un autre contrôle utilisateur qui les contient.
Dérivez de cette classe si vous souhaitez créer un contrôle utilisateur à l’aide de la technique code-behind. Cela est recommandé si vous développez des pages Web Forms à l’aide de cette technique.
Pour plus d’informations sur la création de contrôles utilisateur de manière déclarative, consultez ASP.NET Contrôles utilisateur.
Constructeurs
| Nom | Description |
|---|---|
| UserControl() |
Initialise une nouvelle instance de la classe UserControl. |
Propriétés
| Nom | Description |
|---|---|
| Adapter |
Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| Application |
Obtient l’objet Application de la requête Web actuelle. |
| 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) |
| AppRelativeVirtualPath |
Obtient ou définit le chemin d’accès du répertoire virtuel relatif à l’application vers le fichier à partir duquel le contrôle est analysé et compilé. (Hérité de TemplateControl) |
| Attributes |
Obtient une collection de toutes les paires nom et valeur d’attribut déclarées dans la balise de contrôle utilisateur dans le fichier .aspx. |
| AutoHandlers |
Obsolète.
La AutoHandlers propriété a été déconseillée dans ASP.NET NET 2.0. Il est utilisé par des classes générées et n’est pas destiné à être utilisé dans votre code. (Hérité de TemplateControl) |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| Cache |
Obtient l’objet Cache associé à l’application qui contient le contrôle utilisateur. |
| CachePolicy |
Obtient une référence à une collection de paramètres de mise en cache pour ce contrôle utilisateur. |
| 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) |
| 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) |
| EnableTheming |
Obtient ou définit une valeur booléenne indiquant si les thèmes s’appliquent au contrôle dérivé de la TemplateControl classe. (Hérité de TemplateControl) |
| 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) |
| 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) |
| 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) |
| 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) |
| IsPostBack |
Obtient une valeur indiquant si le contrôle utilisateur est chargé en réponse à une publication différée du client, ou s’il est chargé et accédé pour la première fois. |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control) |
| 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) |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| Request |
Obtient l’objet HttpRequest de la requête Web actuelle. |
| Response |
Obtient l’objet HttpResponse de la requête Web actuelle. |
| Server |
Obtient l’objet HttpServerUtility de la requête Web actuelle. |
| Session |
Obtient l’objet HttpSessionState de la requête Web actuelle. |
| 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 Control) |
| SupportAutoEvents |
Obtient une valeur indiquant si le TemplateControl contrôle prend en charge les événements automatiques. (Hérité de TemplateControl) |
| 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) |
| Trace |
Obtient l’objet TraceContext de la requête Web actuelle. |
| 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) |
| 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) |
Méthodes
| Nom | Description |
|---|---|
| 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 serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur. (Hérité de Control) |
| 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) |
| 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) |
| Construct() |
Effectue une logique au moment du design. (Hérité de TemplateControl) |
| 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) |
| CreateResourceBasedLiteralControl(Int32, Int32, Boolean) |
Accède aux chaînes littérales stockées dans une ressource. La CreateResourceBasedLiteralControl(Int32, Int32, Boolean) méthode n’est pas destinée à être utilisée à partir de votre code. (Hérité de TemplateControl) |
| 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) |
| DesignerInitialize() |
Effectue toutes les étapes d’initialisation sur le contrôle utilisateur requis par les concepteurs RAD. |
| 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) |
| Eval(String, String) |
Évalue une expression de liaison de données à l’aide de la chaîne de format spécifiée pour afficher le résultat. (Hérité de TemplateControl) |
| Eval(String) |
Évalue une expression de liaison de données. (Hérité de TemplateControl) |
| 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) |
| FrameworkInitialize() |
Initialise le contrôle dérivé de la TemplateControl classe. (Hérité de TemplateControl) |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetGlobalResourceObject(String, String, Type, String) |
Obtient un objet de ressource au niveau de l’application en fonction des propriétés, du type d’objet et du nom de propriété spécifiés ClassKeyResourceKey de la ressource. (Hérité de TemplateControl) |
| GetGlobalResourceObject(String, String) |
Obtient un objet de ressource au niveau de l’application en fonction des propriétés et ResourceKey des propriétés spécifiéesClassKey. (Hérité de TemplateControl) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetLocalResourceObject(String, Type, String) |
Obtient un objet de ressource au niveau de la page en fonction de la propriété, du type d’objet et du nom de propriété spécifiés ResourceKey . (Hérité de TemplateControl) |
| GetLocalResourceObject(String) |
Obtient un objet de ressource au niveau de la page en fonction de la propriété spécifiée ResourceKey . (Hérité de TemplateControl) |
| 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) |
| 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) |
| InitializeAsUserControl(Page) |
Initialise l’objet UserControl créé de manière déclarative. Étant donné qu’il existe des différences entre les pages et les contrôles utilisateur, cette méthode garantit que le contrôle utilisateur est initialisé correctement. |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| LoadControl(String) |
Charge un Control objet à partir d’un fichier basé sur un chemin d’accès virtuel spécifié. (Hérité de TemplateControl) |
| LoadControl(Type, Object[]) |
Charge un Control objet basé sur un type et des paramètres de constructeur spécifiés. (Hérité de TemplateControl) |
| 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) |
| LoadTemplate(String) |
Obtient une instance de l’interface ITemplate à partir d’un fichier externe. (Hérité de TemplateControl) |
| LoadViewState(Object) |
Restaure les informations d’état d’affichage à partir d’une demande de contrôle utilisateur précédente enregistrée par la SaveViewState() méthode. |
| MapPath(String) |
Affecte un chemin d’accès de fichier virtuel, absolu ou relatif, à un chemin d’accès de fichier physique. |
| 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) |
| OnAbortTransaction(EventArgs) |
Déclenche l’événement AbortTransaction. (Hérité de TemplateControl) |
| 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) |
| OnCommitTransaction(EventArgs) |
Déclenche l’événement CommitTransaction. (Hérité de TemplateControl) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnError(EventArgs) |
Déclenche l’événement Error. (Hérité de TemplateControl) |
| 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. (Hérité de Control) |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control) |
| ParseControl(String, Boolean) |
Analyse une chaîne d’entrée dans un Control objet sur la page web ASP.NET ou le contrôle utilisateur. (Hérité de TemplateControl) |
| ParseControl(String) |
Analyse une chaîne d’entrée dans un Control objet sur la page Web Forms ou le contrôle utilisateur. (Hérité de TemplateControl) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| ReadStringResource() |
Lit une ressource de chaîne. La ReadStringResource() méthode n’est pas destinée à être utilisée à partir de votre code. (Hérité de TemplateControl) |
| 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) |
Envoie le contenu du contrôle serveur à un objet fourni HtmlTextWriter , qui écrit le contenu à afficher sur le client. (Hérité de Control) |
| 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) |
| 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) |
| 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 les modifications de l’état d’affichage du contrôle utilisateur qui se sont produites depuis la dernière publication de page. |
| 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) |
| SetStringResourcePointer(Object, Int32) |
Définit un pointeur vers une ressource de chaîne. La SetStringResourcePointer(Object, Int32) méthode est utilisée par les classes générées et n’est pas destinée à être utilisée à partir de votre code. (Hérité de TemplateControl) |
| 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) |
| TestDeviceFilter(String) |
Retourne une valeur booléenne indiquant si un filtre d’appareil s’applique à la requête HTTP. (Hérité de TemplateControl) |
| 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é. (Hérité de Control) |
| TryUpdateModel<TModel>(TModel, IValueProvider) |
Tente de mettre à jour l’instance de modèle à l’aide de valeurs du fournisseur de valeurs. |
| TryUpdateModel<TModel>(TModel) |
Tente de mettre à jour l’instance de modèle à l’aide des valeurs du contrôle lié aux données. |
| UpdateModel<TModel>(TModel, IValueProvider) |
Met à jour l’instance de modèle spécifiée à l’aide de valeurs du fournisseur de valeurs du contrôle utilisateur. |
| UpdateModel<TModel>(TModel) |
Met à jour l’instance de modèle à l’aide de valeurs du contrôle lié aux données. |
| WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) |
Écrit une chaîne de ressource dans un HtmlTextWriter contrôle. La WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) méthode est utilisée par les classes générées et n’est pas destinée à être utilisée à partir de votre code. (Hérité de TemplateControl) |
| XPath(String, IXmlNamespaceResolver) |
Évalue une expression de liaison de données XPath à l’aide des mappages de préfixe et d’espace de noms spécifiés pour la résolution d’espace de noms. (Hérité de TemplateControl) |
| XPath(String, String, IXmlNamespaceResolver) |
Évalue une expression de liaison de données XPath à l’aide des mappages de préfixe et d’espace de noms spécifiés pour la résolution de l’espace de noms et la chaîne de format spécifiée pour afficher le résultat. (Hérité de TemplateControl) |
| XPath(String, String) |
Évalue une expression de liaison de données XPath à l’aide de la chaîne de format spécifiée pour afficher le résultat. (Hérité de TemplateControl) |
| XPath(String) |
Évalue une expression de liaison de données XPath. (Hérité de TemplateControl) |
| XPathSelect(String, IXmlNamespaceResolver) |
Évalue une expression de liaison de données XPath à l’aide des mappages de préfixe et d’espace de noms spécifiés pour la résolution d’espaces de noms et retourne une collection de nœuds qui implémente l’interface IEnumerable . (Hérité de TemplateControl) |
| XPathSelect(String) |
Évalue une expression de liaison de données XPath et retourne une collection de nœuds qui implémente l’interface IEnumerable . (Hérité de TemplateControl) |
Événements
| Nom | Description |
|---|---|
| AbortTransaction |
Se produit lorsqu’un utilisateur termine une transaction. (Hérité de TemplateControl) |
| CommitTransaction |
Se produit lorsqu’une transaction est terminée. (Hérité de TemplateControl) |
| 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) |
| Error |
Se produit lorsqu’une exception non gérée est levée. (Hérité de TemplateControl) |
| 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) |
Retourne la valeur de l’attribut de contrôle utilisateur spécifié. |
| IAttributeAccessor.SetAttribute(String, String) |
Définit la valeur de l’attribut de contrôle utilisateur spécifié. |
| 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) |
| IFilterResolutionService.CompareFilters(String, String) |
Retourne une valeur qui indique si une relation parent/enfant existe entre deux filtres d’appareil spécifiés. (Hérité de TemplateControl) |
| IFilterResolutionService.EvaluateFilter(String) |
Retourne une valeur qui indique si le filtre spécifié est un type de l’objet de filtre actuel. (Hérité de TemplateControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
| IUserControlDesignerAccessor.InnerText |
Obtient ou définit le texte qui apparaît entre les balises d’ouverture et de fermeture d’un contrôle utilisateur. |
| IUserControlDesignerAccessor.TagName |
Obtient ou définit le nom complet de l’étiquette du contrôle utilisateur. |
Méthodes d’extension
| Nom | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type, Object) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| EnableDynamicData(INamingContainer, Type) |
Active le comportement des données dynamiques pour le contrôle de données spécifié. |
| 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. |
| GetDefaultValues(INamingContainer) |
Obtient la collection des valeurs par défaut pour le contrôle de données spécifié. |
| GetMetaTable(INamingContainer) |
Obtient les métadonnées de table pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié. |
| SetMetaTable(INamingContainer, MetaTable) |
Définit les métadonnées de table pour le contrôle de données spécifié. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Détermine si les métadonnées de table sont disponibles. |