MasterPage 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 conteneur de modèle et de fusion pour les pages qui sont composées uniquement de contrôles Content et de leurs contrôles enfants respectifs.
public ref class MasterPage : System::Web::UI::UserControl
public class MasterPage : System.Web.UI.UserControl
type MasterPage = class
inherit UserControl
Public Class MasterPage
Inherits UserControl
- Héritage
Exemples
Cette section contient quatre exemples de code :
Le premier exemple de code montre comment créer une page maître de manière déclarative.
Le deuxième exemple de code représente la page de contenu associée à la page maître créée dans le premier exemple de code.
Le troisième exemple de code montre comment ajouter une propriété à une page maître.
Le quatrième exemple de code montre comment utiliser une page de contenu pour accéder à une propriété publique sur la page maître.
L’exemple suivant montre comment créer une page maître de manière déclarative et y ajouter du contenu à l’aide d’une page de contenu. La première page web est la page .master nommée MasterPageSample_1.master
.
<%@ Master Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
</div>
</form>
</body>
</html>
<%@ Master Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
</div>
</form>
</body>
</html>
L’exemple suivant représente la page de contenu associée à MasterPageSample_1.master
. Il contient un Content contrôle et identifie le ContentPlaceHolder contrôle auquel le contenu est associé à l’aide de la ContentPlaceHolderID propriété .
<%@ Page Language="C#" MasterPageFile="~/MasterPageSample_1cs.master" Title="Content Page"%>
<asp:content
runat="server"
contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>
<%@ Page Language="VB" MasterPageFile="~/MasterPageSample_1vb.master" Title="Content Page"%>
<asp:content
runat="server"
contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>
L’exemple suivant montre comment ajouter une propriété à une page maître. L’attribut ClassName
est utilisé pour nommer la page maître.
<%@ Master Language="C#" ClassName="MasterExample" %>
<script runat="server">
public string SiteName
{
get { return "My Site Name"; }
}
</script>
<html >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
</asp:contentplaceholder>
</div>
</form>
</body>
</html>
<%@ Master Language="VB" ClassName="MasterExample" %>
<script runat="server">
Public ReadOnly Property SiteName() As String
Get
Return "My Site Name"
End Get
End Property
</script>
<html >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
</asp:contentplaceholder>
</div>
</form>
</body>
</html>
L’exemple suivant montre comment utiliser une page de contenu pour accéder à la propriété SiteName
publique de la page maître dans l’exemple de code précédent.
<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
MasterExample m = (MasterExample)Page.Master;
mylabel.Text = m.SiteName;
}
</script>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
Hello, Master Pages!
<asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>
<%@ Page Language="VB" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
Dim m As MasterExample = CType(Page.Master, MasterPage)
mylabel.Text = m.SiteName
End Sub
</script>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
Hello, Master Pages!
<asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>
Remarques
Une page maître fonctionne comme un conteneur de modèles et une page de fusion pour les pages de contenu dans votre application web ASP.NET. Les pages maîtres offrent un moyen pratique de partager la structure et le contenu entre un ensemble de pages de contenu. Vous utilisez des espaces réservés de contenu pour définir les sections de la page maître à remplacer par du contenu des pages de contenu.
Lorsque vous utilisez une page maître et ses pages de contenu associées, vous ajoutez les balises de document XHTML requises (telles que html
, head
et body
) uniquement à la page maître et ne créez plus vos autres fichiers .aspx (ASP.NET pages) en tant que pages Web autonomes. Les pages de contenu définissent le contenu à insérer dans les espaces réservés de la page maître.
Lorsqu’une requête HTTP est effectuée pour une page au moment de l’exécution, la page maître et les pages de contenu sont combinées en une seule classe portant le même nom que les pages de contenu. La classe compilée et fusionnée résultante dérive de la Page classe .
Une page maître peut contenir des contrôles de balisage et de serveur directs, ainsi que des contrôles de conteneur. Chaque élément placé dans la page maître en dehors d’un ContentPlaceHolder contrôle est rendu sur toutes les pages résultant de la fusion de la page maître et des pages de contenu.
Chaque page de contenu liée à la page maître doit référencer la page maître dans un MasterPageFile
attribut de sa directive @ Page . Les pages de contenu ne peuvent contenir qu’une @ Page
directive et un ou plusieurs Content contrôles. Tous vos contrôles de texte de page, de balisage et de serveur doivent être placés dans Content des contrôles. Vous identifiez le ContentPlaceHolder contrôle d’une page maître à laquelle un Content contrôle est associé en définissant la ContentPlaceHolderID propriété du Content contrôle.
Au moment de l’exécution, le contenu dynamique de chaque Content contrôle de la page demandée est fusionné avec la page maître à l’emplacement exact du contrôle associé ContentPlaceHolder . Les autres balises et contrôles de la page maître ne sont pas affectés. Les gestionnaires d’événements peuvent être définis à la fois dans la classe maître et sur la page de contenu. Pour plus d’informations, consultez Événements dans ASP.NET pages maîtres et de contenu.
La MasterPage classe est associée aux fichiers qui ont une extension .master. Ces fichiers sont compilés au moment de l’exécution en tant qu’objets MasterPage et sont mis en cache dans la mémoire du serveur.
La page maître est mise à la disposition de la page de contenu via la Master propriété de la classe de base Page . La Master propriété retourne l’instance de la page maître ; toutefois, elle est tapée en tant que classe de base MasterPage . Pour accéder aux contrôles, aux propriétés et aux fonctions de la page maître, la Master propriété peut être convertie en objet MasterPage . Le nom de la classe de la page maître est défini à l’aide de l’attribut ClassName
de la directive @Master .
Notes
Les fichiers avec des extensions .master ne sont pas servis à un navigateur.
Les directives valides sur une page maître sont les mêmes que celles disponibles sur un UserControl objet. Ils peuvent inclure les attributs suivants :
AutoEventWireup
ClassName
CodeFile
CompilerMode
CompilerOptions
Debug
Description
EnableTheming
EnableViewState
Explicit
Inherits
Language
LinePragmas
MasterPageFile
Src
Strict
WarningLevel
Les directives de page maître ne remplacent pas les directives sur les pages de contenu individuelles.
Les pages maîtres sont le plus souvent créées de manière déclarative. Si vous souhaitez créer une page maître par programmation, dérivez directement de la MasterPage classe . En plus d’étendre la MasterPage classe, vous devez créer le fichier .master pour afficher visuellement l’interface utilisateur associée aux classes que vous avez appelées dans votre fichier source.
Notes
Lorsque vous créez une page maître en créant d’abord votre propre classe, vous devez inclure tous les espaces de noms requis pour les classes utilisées par la page.
Pour plus d’informations sur les pages maîtres, consultez pages maîtres ASP.NET.
Constructeurs
MasterPage() |
Crée une instance de la classe MasterPage. |
Propriétés
Adapter |
Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
Application |
Obtient l’objet Application pour la requête Web actuelle. (Hérité de UserControl) |
AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl 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 qui mène au fichier depuis lequel le contrôle est analysé et compilé. (Hérité de TemplateControl) |
Attributes |
Obtient une collection de toutes les paires nom/valeur d'attribut déclarées dans la balise du contrôle utilisateur au sein d'un fichier .aspx. (Hérité de UserControl) |
AutoHandlers |
Obsolète.
La propriété AutoHandlers a été dépréciée dans ASP.NET 2.0. Elle est utilisée par les classes générées et n'est pas conçue pour être utilisée 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. (Hérité de UserControl) |
CachePolicy |
Obtient une référence à une collection de paramètres de mise en cache pour ce contrôle utilisateur. (Hérité de UserControl) |
ChildControlsCreated |
Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
ClientID |
Obtient l’ID de contrôle du 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 propriété ClientID. (Hérité de Control) |
ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control) |
ContentPlaceHolders |
Obtient une liste de contrôles ContentPlaceHolder que la page maître utilise pour définir différentes régions de contenu. |
ContentTemplates |
Obtient une liste des contrôles de contenu qui sont associés à la page maître. |
Context |
Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control) |
Controls |
Obtient un objet ControlCollection qui représente les contrôles enfants pour 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'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control) |
DataKeysContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control) |
DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control) |
EnableTheming |
Obtient ou définit une valeur Boolean qui indique si des thèmes s'appliquent au contrôle dérivé de la classe TemplateControl. (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 de tous les contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
Events |
Obtient la liste des délégués de gestionnaires 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 en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control) |
ID |
Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control) |
IdSeparator |
Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control) |
IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control) |
IsPostBack |
Obtient une valeur indiquant si le contrôle utilisateur est en cours de chargement en réponse à une publication (postback) du client ou suite à une première demande d'accès. (Hérité de UserControl) |
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 par ID et non par index. (Hérité de Control) |
Master |
Obtient la page maître parente du maître en cours dans les scénarios de pages maîtres imbriquées. |
MasterPageFile |
Obtient ou définit le nom de la page maître qui contient le contenu en cours. |
NamingContainer |
Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur. (Hérité de Control) |
Page |
Obtient une référence à l'instance de 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 la page. (Hérité de Control) |
RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control) |
Request |
Obtient l’objet HttpRequest pour la requête Web actuelle. (Hérité de UserControl) |
Response |
Obtient l’objet HttpResponse pour la requête Web actuelle. (Hérité de UserControl) |
Server |
Obtient l’objet HttpServerUtility pour la requête Web actuelle. (Hérité de UserControl) |
Session |
Obtient l’objet HttpSessionState pour la requête Web actuelle. (Hérité de UserControl) |
Site |
Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control) |
SkinID |
Obtient ou définit l’apparence à appliquer au contrôle. (Hérité de Control) |
SupportAutoEvents |
Obtient une valeur qui indique si le contrôle TemplateControl prend en charge des é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 Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control) |
Trace |
Obtient l’objet TraceContext pour la requête Web actuelle. (Hérité de UserControl) |
UniqueID |
Obtient l'identificateur unique qualifié sur le plan hiérarchique du 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 cliente du navigateur à la recherche de 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 entre plusieurs demandes de la même page. (Hérité de Control) |
ViewStateIgnoresCase |
Obtient une valeur qui indique si l'objet StateBag respecte la 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
AddContentTemplate(String, ITemplate) |
Ajoute un contrôle Content au dictionnaire ContentTemplates. |
AddedControl(Control, Int32) |
Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls 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 ControlCollection du contrôle serveur. (Hérité de Control) |
ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control) |
BeginRenderTracing(TextWriter, Object) |
Commence le traçage 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 les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control) |
ClearCachedClientID() |
Affecte à la valeur ClientID mise en cache la valeur |
ClearChildControlState() |
Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control) |
ClearChildState() |
Supprime les informations sur l'état d'affichage et sur l'état du contrôle de 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() |
Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control) |
Construct() |
Exécute une logique au moment du design. (Hérité de TemplateControl) |
CreateChildControls() |
Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu. (Hérité de Control) |
CreateControlCollection() |
Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux 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 méthode CreateResourceBasedLiteralControl(Int32, Int32, Boolean) n'est pas conçue pour ê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 sur le contrôle utilisateur les étapes d'initialisation requises par les concepteurs de développement rapide d'application (RAD, Rapid-Application Development). (Hérité de UserControl) |
Dispose() |
Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control) |
EndRenderTracing(TextWriter, Object) |
Met fin au traçage 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. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control) |
EnsureID() |
Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
Eval(String) |
Évalue une expression de liaison de données. (Hérité de TemplateControl) |
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) |
FindControl(String) |
Recherche un contrôle serveur possédant le paramètre |
FindControl(String, Int32) |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
Focus() |
Affecte le focus d'entrée à un contrôle. (Hérité de Control) |
FrameworkInitialize() |
Initialise le contrôle dérivé de la classe TemplateControl. (Hérité de TemplateControl) |
GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
GetGlobalResourceObject(String, String) |
Obtient un objet de ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées. (Hérité de TemplateControl) |
GetGlobalResourceObject(String, String, Type, String) |
Obtient un objet ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées, un type d'objet et un nom de propriété de la ressource. (Hérité de TemplateControl) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetLocalResourceObject(String) |
Obtient un objet ressource au niveau de la page selon la propriété ResourceKey spécifiée. (Hérité de TemplateControl) |
GetLocalResourceObject(String, Type, String) |
Obtient un objet ressource au niveau de la page selon les propriétés ResourceKey spécifiée, un type d'objet et un nom de propriété. (Hérité de TemplateControl) |
GetRouteUrl(Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
GetRouteUrl(RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
GetRouteUrl(String, Object) |
Obtient l'URL qui correspond à un jeu 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 jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la propriété UniqueID 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 des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control) |
InitializeAsUserControl(Page) |
Initialise l'objet UserControl créé de manière déclarative. Comme il y a quelques différences entre les pages et les contrôles utilisateur, cette méthode assure une initialisation correcte du contrôle utilisateur. (Hérité de UserControl) |
InstantiateInContentPlaceHolder(Control, ITemplate) |
Fournit une méthode pour affecter le contrôle de modèle actuel à une page propriétaire de la page maître. |
IsLiteralContent() |
Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control) |
LoadControl(String) |
Charge un objet Control à partir d'un fichier en fonction d'un chemin d'accès virtuel spécifié. (Hérité de TemplateControl) |
LoadControl(Type, Object[]) |
Charge un objet Control selon un type et des paramètres de constructeur spécifiés. (Hérité de TemplateControl) |
LoadControlState(Object) |
Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState(). (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 d’une demande de contrôle utilisateur précédente enregistrée par la méthode SaveViewState(). (Hérité de UserControl) |
MapPath(String) |
Assigne un chemin d'accès virtuel, absolu ou relatif, à un chemin d'accès physique à un fichier. (Hérité de UserControl) |
MapPathSecure(String) |
Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (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 du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’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. (Hérité de UserControl) |
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 utilisé pour lire un fichier. (Hérité de Control) |
ParseControl(String) |
Analyse une chaîne d'entrée dans un objet Control sur la page Web Forms ou le contrôle utilisateur. (Hérité de TemplateControl) |
ParseControl(String, Boolean) |
Analyse une chaîne d'entrée dans un objet Control sur la page Web ASP.NET ou le contrôle utilisateur. (Hérité de TemplateControl) |
RaiseBubbleEvent(Object, EventArgs) |
Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control) |
ReadStringResource() |
Lit une ressource de type chaîne. La méthode ReadStringResource() n'est pas conçue pour être utilisée à partir de votre code. (Hérité de TemplateControl) |
RemovedControl(Control) |
Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
Render(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter, qui écrit le contenu à rendre sur le client. (Hérité de Control) |
RenderChildren(HtmlTextWriter) |
Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control) |
RenderControl(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé. (Hérité de Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control) |
ResolveAdapter() |
Obtient l'adaptateur de contrôles 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 que le client soit en mesure d'utiliser. (Hérité de Control) |
SaveControlState() |
Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur. (Hérité de Control) |
SaveViewState() |
Enregistre toute modification de l'état d'affichage du contrôle utilisateur survenue depuis la dernière publication (postback) de page. (Hérité de UserControl) |
SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
SetRenderMethodDelegate(RenderMethod) |
Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control) |
SetStringResourcePointer(Object, Int32) |
Définit un pointeur sur une ressource de type chaîne. La méthode SetStringResourcePointer(Object, Int32) est utilisée par des classes générées et n'est pas conçue pour être utilisée dans votre code. (Hérité de TemplateControl) |
SetTraceData(Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
TestDeviceFilter(String) |
Retourne une valeur Boolean qui indique si un filtre pour appareil mobile 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 de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. Cet objet est accessible via la propriété ViewState. (Hérité de Control) |
TryUpdateModel<TModel>(TModel) |
Tente de mettre à jour l'instance de modèle à l'aide des valeurs du contrôle lié aux données. (Hérité de UserControl) |
TryUpdateModel<TModel>(TModel, IValueProvider) |
Tente de mettre à jour l'instance de modèle spécifiée en utilisant des valeurs du fournisseur de valeurs. (Hérité de UserControl) |
UpdateModel<TModel>(TModel) |
Met à jour l’instance de modèle à l’aide des valeurs du contrôle lié aux données. (Hérité de UserControl) |
UpdateModel<TModel>(TModel, IValueProvider) |
Met à jour l’instance de modèle spécifiée à l’aide de valeurs issues du fournisseur de valeurs du contrôle utilisateur. (Hérité de UserControl) |
WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) |
Écrit une chaîne de ressource dans un contrôle HtmlTextWriter. La méthode WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) est utilisée par des classes générées et n'est pas conçue pour être utilisée dans votre code. (Hérité de TemplateControl) |
XPath(String) |
Évalue une expression de liaison de données XPath. (Hérité de TemplateControl) |
XPath(String, IXmlNamespaceResolver) |
Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms. (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, String, IXmlNamespaceResolver) |
Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms, et de la chaîne de format spécifiée pour afficher le résultat. (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) |
XPathSelect(String, IXmlNamespaceResolver) |
Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces 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) |
Événements
AbortTransaction |
Se produit lorsqu'un utilisateur met fin à une transaction. (Hérité de TemplateControl) |
CommitTransaction |
Se produit lorsqu'une transaction se termine. (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, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (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é, ce qui constitue 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
IAttributeAccessor.GetAttribute(String) |
Retourne la valeur de l’attribut de contrôle utilisateur spécifié. (Hérité de UserControl) |
IAttributeAccessor.SetAttribute(String, String) |
Définit la valeur de l’attribut de contrôle utilisateur spécifié. (Hérité de UserControl) |
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 pour appareils mobiles 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 compris entre les balises d'ouverture et de fermeture d'un contrôle utilisateur. (Hérité de UserControl) |
IUserControlDesignerAccessor.TagName |
Obtient ou définit le nom complet de la balise du contrôle utilisateur. (Hérité de UserControl) |
Méthodes d’extension
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 pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. |
FindMetaTable(Control) |
Retourne l'objet Metatable pour le contrôle de données conteneur. |
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) |
Définit 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 des 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 des valeurs par défaut pour le contrôle de données spécifié. |
TryGetMetaTable(INamingContainer, MetaTable) |
Détermine si des métadonnées de table sont disponibles. |
EnableDynamicData(INamingContainer, Type) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |
EnableDynamicData(INamingContainer, Type, Object) |
Active le comportement Dynamic Data pour le contrôle de données spécifié. |