MasterPage Classe

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

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

Agit en tant que modèle et conteneur de fusion pour les pages composées uniquement de Content contrôles 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: Object

Control

TemplateControl

UserControl
MasterPage

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 sur la page maître de 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 sur 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, headet ) uniquement à la page maître et bodyne 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 dans 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 les contrôles de texte, de balisage et de serveur de votre page doivent être placés dans des Content 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 . Tout autre balisage et contrôle dans la page maître n’est pas affecté. Les gestionnaires d’événements peuvent être définis à la fois dans la classe maître et dans 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 typée comme classe de base MasterPage . Pour accéder aux contrôles, propriétés et fonctions de la page maître, la Master propriété peut être convertie en objet MasterPage . Le nom de classe de la page maître est défini à l’aide de l’attribut ClassName de la directive @ Master .

Note

Les fichiers avec des extensions .master ne sont pas servis à un navigateur.

Les directives valides sur une page maître sont identiques à 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 des pages de contenu individuelles.

Les pages maîtres sont les 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. Outre l’extension de 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.

Note

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 ASP.NET Pages maîtres.

Constructeurs

Nom	Description
MasterPage()	Crée une instance de la MasterPage classe.

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. (Hérité de UserControl)
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. (Hérité de UserControl)
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. (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 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)
ContentPlaceHolders	Obtient une liste de ContentPlaceHolder contrôles que la page maître utilise pour définir différentes régions de contenu.
ContentTemplates	Obtient une liste de contrôles de contenu associés à la page maître.
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. (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 ID au lieu de l’index. (Hérité de Control)
Master	Obtient la page maître parente du maître actuel 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 actuel.
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. (Hérité de UserControl)
Response	Obtient l’objet HttpResponse de la requête Web actuelle. (Hérité de UserControl)
Server	Obtient l’objet HttpServerUtility de la requête Web actuelle. (Hérité de UserControl)
Session	Obtient l’objet HttpSessionState de la requête Web actuelle. (Hérité de UserControl)
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 Page UserControl ou qui contient le contrôle serveur actuel. (Hérité de Control)
Trace	Obtient l’objet TraceContext de la requête Web actuelle. (Hérité de UserControl)
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
AddContentTemplate(String, ITemplate)	Ajoute un Content contrôle au ContentTemplates dictionnaire.
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 `null`. (Hérité de Control)
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. (Hérité de UserControl)
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é `id` et spécifié dans le `pathOffset` paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode. (Hérité de Control)
FindControl(String)	Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié `id` . (Hérité de Control)
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 ClassKey ResourceKey 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. (Hérité de UserControl)
InstantiateInContentPlaceHolder(Control, ITemplate)	Fournit une méthode pour définir le contrôle de modèle actuel sur une page propriétaire de la page maître.
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. (Hérité de UserControl)
MapPath(String)	Affecte un chemin d’accès de fichier virtuel, absolu ou relatif, à un chemin d’accès de fichier physique. (Hérité de UserControl)
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. (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 é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. (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)	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. (Hérité de UserControl)
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)
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. (Hérité de UserControl)
UpdateModel<TModel>(TModel)	Met à jour l’instance de modèle à l’aide de valeurs du contrôle lié aux données. (Hérité de UserControl)
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é. (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 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. (Hérité de UserControl)
IUserControlDesignerAccessor.TagName	Obtient ou définit le nom complet de l’étiquette du contrôle utilisateur. (Hérité de UserControl)

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.

S’applique à

Voir aussi

Commentaires

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