WebPart Classe

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

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.

Sert de classe de base pour les contrôles de composants WebPart personnalisés ASP.NET, en ajoutant aux fonctionnalités de classe de base Part des propriétés d’interface utilisateur supplémentaires, la possibilité de créer des connexions et le comportement de personnalisation.

public ref class WebPart abstract : System::Web::UI::WebControls::WebParts::Part, System::Web::UI::WebControls::WebParts::IWebActionable, System::Web::UI::WebControls::WebParts::IWebEditable, System::Web::UI::WebControls::WebParts::IWebPart

public abstract class WebPart : System.Web.UI.WebControls.WebParts.Part, System.Web.UI.WebControls.WebParts.IWebActionable, System.Web.UI.WebControls.WebParts.IWebEditable, System.Web.UI.WebControls.WebParts.IWebPart

type WebPart = class
    inherit Part
    interface IWebPart
    interface IWebActionable
    interface IWebEditable

Public MustInherit Class WebPart
Inherits Part
Implements IWebActionable, IWebEditable, IWebPart

Héritage: Object

Control

WebControl

Panel

Part
WebPart

Dérivé: System.Web.UI.WebControls.WebParts.GenericWebPart

System.Web.UI.WebControls.WebParts.ProxyWebPart

Implémente: IWebActionable IWebEditable IWebPart

Exemples

L’exemple de code suivant montre comment créer un WebPart contrôle et le référencer dans une page Web.

La première partie de l’exemple contient le code d’un contrôle personnalisé WebPart nommé TextDisplayWebPart. Ce contrôle montre comment créer un contrôle personnalisé WebPart simple qui vous donne accès aux fonctionnalités du jeu de contrôles Composants WebPart. Pour que l’exemple de code s’exécute, vous devez compiler ce code source. Vous pouvez le compiler explicitement et placer l’assembly résultant dans le dossier Bin de votre site web ou dans le Global Assembly Cache. Vous pouvez également placer le code source dans le dossier App_Code de votre site, où il sera compilé dynamiquement au moment de l’exécution. Cet exemple de code suppose que vous compilez le code source dans un assembly, placez-le dans un sous-dossier Bin de votre application web et référencez l’assembly avec une Register directive dans votre page Web. Pour obtenir une procédure pas à pas qui illustre les deux méthodes de compilation, consultez Procédure pas à pas : développement et utilisation d’un contrôle serveur web personnalisé.

using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;

    public TextDisplayWebPart()
    {
      this.AllowClose = false;
    }

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = 
        System.Drawing.Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);
      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
      ChildControlsCreated = true;
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    
    
    Public Sub New() 
      Me.AllowClose = False
    End Sub
    
    <Personalizable(), WebBrowsable()>  _
    Public Property ContentText() As String 
        Get
            Return _contentText
        End Get
        Set
            _contentText = value
        End Set
    End Property
     
    Protected Overrides Sub CreateChildControls() 
        Controls.Clear()
        DisplayContent = New Label()
        DisplayContent.Text = Me.ContentText
        DisplayContent.BackColor = _
          System.Drawing.Color.LightBlue
        Me.Controls.Add(DisplayContent)
        input = New TextBox()
        Me.Controls.Add(input)
        Dim update As New Button()
        update.Text = "Set Label Content"
        AddHandler update.Click, AddressOf Me.submit_Click
        Me.Controls.Add(update)
        ChildControlsCreated = True
    
    End Sub
    
    
    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs) 
        ' Update the label string.
        If input.Text <> String.Empty Then
            _contentText = input.Text & "<br />"
            input.Text = String.Empty
            DisplayContent.Text = Me.ContentText
        End If
    
    End Sub
    
End Class

End Namespace

La deuxième partie de l’exemple montre comment référencer le TextDisplayWebPart contrôle dans une page web ASP.NET. Notez que la plupart des différentes WebPart propriétés peuvent être attribuées de manière déclarative au contrôle personnalisé.

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Remarques

Lorsque vous créez des contrôles avec des fonctionnalités de composants WebPart, vous avez deux options de base. Vous pouvez créer des contrôles personnalisés qui dérivent de la WebPart classe, ou vous pouvez créer ou utiliser d’autres contrôles serveur. Les contrôles de ASP.NET existants, les contrôles serveur personnalisés et les contrôles utilisateur peuvent tous être dotés de fonctionnalités complètes de composants WebPart en les déclarant dans (ou en les ajoutant par programmation) à un WebPartZone contrôle de zone, ce qui entraîne l’encapsulé avec GenericWebPart des objets au moment de l’exécution et traités comme des contrôles vrais WebPart . Pour plus d’informations, consultez la documentation de la GenericWebPart classe. Pour accélérer le développement et la réutilisation maximale du code, l’utilisation de contrôles serveur existants peut être une bonne option. Pour un contrôle programmatique maximal sur le comportement et les fonctionnalités de composants WebPart des contrôles, la création d’un contrôle personnalisé qui hérite de la WebPart classe est souvent la meilleure option.

La classe abstraite WebPart hérite du contrôle de base Part et fournit les éléments de base pour tous les WebPart contrôles. La classe inclut un ensemble commun de propriétés qui affectent l’apparence de l’interface utilisateur. Les AllowClosepropriétés , AllowEdit AllowMinimize AllowConnect AllowHide AllowZoneChange et spécifient chacune si l’utilisateur d’une application web est autorisé à interagir avec le contrôle de composant de la façon indiquée par le nom de propriété donné. Les CatalogIconImageUrlpropriétés , ChromeType Description Title Width Height ChromeState Hidden TitleIconImageUrl HelpUrl TitleUrlet déterminent la taille, la visibilité, l’apparence et le contenu de prise en charge (par exemple, un titre et une description) pour un WebPart contrôle.

La relation d’un WebPart contrôle à son contexte dans le jeu de contrôles Composants WebPart est déterminée par des propriétés telles que WebPartManager, qui contient une référence à l’objet associé WebPartManager du contrôle et Zone, qui fait référence au WebZone contrôle. Il ne peut y avoir qu’un seul WebPartManager contrôle par page, et chaque instance d’un WebPart contrôle ne peut résider qu’une seule WebZone à la fois.

Note

Un WebPart contrôle peut être placé en dehors d’une zone sur une page Web, mais dans ce cas, il fonctionne comme un contrôle serveur normal et perd presque toutes les fonctionnalités de composants WebPart.

Plusieurs autres propriétés importantes affectent les fonctionnalités uniques des WebPart contrôles. La AuthorizationFilter propriété permet aux développeurs de définir une chaîne arbitraire qui peut être utilisée comme filtre au moment de l’exécution pour déterminer si un contrôle est ajouté à la page. Utilisée avec une fonctionnalité telle que la gestion des rôles, la AuthorizationFilter propriété fournit un mécanisme utile pour créer des vues basées sur des rôles d’utilisateur définis. La ExportMode propriété indique si, pendant une exportation, toutes les données de propriété disponibles sur un contrôle sont exportées ou uniquement les données non sensibles. Cela permet aux développeurs de faire la distinction entre les données sensibles et les données qui ne sont pas, à des fins de sécurité. La WebBrowsableObject propriété retourne une référence à une instance d’un WebPart contrôle, afin qu’un EditorPart contrôle puisse le modifier lorsque la page est en mode édition. Enfin, il existe plusieurs propriétés qui indiquent l’état du contrôle par rapport au reste de la page. La IsClosed propriété indique si un contrôle est fermé (et ainsi ajouté à un PageCatalogPart objet), ou s’il est ouvert et disponible sur la page. La IsShared propriété indique si un contrôle est un contrôle partagé (par rapport à un contrôle spécifique à l’utilisateur), ce qui signifie qu’il est visible pour tous les utilisateurs d’une page Web. La IsStandalone propriété indique si un contrôle est actuellement contenu dans une WebPartZoneBasezone dérivée (par exemple WebPartZone). Une valeur indiquant false que le contrôle se trouve à l’intérieur d’une zone et dispose donc de fonctionnalités de composants WebPart complètes. La IsStatic propriété indique si un contrôle est statique ou dynamique. Un contrôle statique est déclaré dans le balisage d’une page Web, tandis qu’un contrôle dynamique est ajouté par programmation.

La WebPart classe fournit également plusieurs méthodes qui déterminent ce qui se passe à différents points dans le cycle de vie du contrôle. Par exemple, les méthodes et OnEditModeChanged les OnConnectModeChanged méthodes peuvent être remplacées dans une classe dérivée pour fournir un contrôle programmatique sur le rendu du contenu d’un contrôle pendant l’événement qui correspond au nom de chaque méthode.

Les classes dérivées WebPart peuvent ajouter des WebPartVerb objets à la Verbs collection. Les verbes sont rendus dans un menu verbes, qui apparaît dans la barre de titre d’un WebPart contrôle. WebPartVerb les objets fournissent des éléments d’interface utilisateur simples pour les actions utilisateur courantes telles que le masquage ou la réduction du contrôle ou l’affichage de l’aide.

La CreateEditorParts méthode crée une collection de contrôles personnalisés EditorPart associés à un WebPart contrôle. Les développeurs peuvent remplacer cette méthode afin qu’elle crée des contrôles personnalisés conçus spécifiquement pour modifier leur WebPart contrôle. La méthode est appelée lorsqu’un utilisateur clique sur le verbe modifier sur un WebPart contrôle.

Constructeurs

Nom	Description
WebPart()	Initialise la classe à utiliser par une instance de classe héritée. Ce constructeur ne peut être appelé que par une classe héritée.

Propriétés

Nom	Description
AccessKey	Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web. (Hérité de WebControl)
Adapter	Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control)
AllowClose	Obtient ou définit une valeur indiquant si un utilisateur final peut fermer un WebPart contrôle sur une page Web.
AllowConnect	Obtient ou définit une valeur qui indique si le WebPart contrôle autorise d’autres contrôles à former des connexions avec celui-ci.
AllowEdit	Obtient ou définit une valeur indiquant si un utilisateur final peut modifier un WebPart contrôle via l’interface utilisateur fournie par un ou plusieurs EditorPart contrôles.
AllowHide	Obtient ou définit une valeur indiquant si les utilisateurs finaux sont autorisés à masquer un WebPart contrôle.
AllowMinimize	Obtient ou définit une valeur indiquant si les utilisateurs finaux peuvent réduire un WebPart contrôle.
AllowZoneChange	Obtient ou définit une valeur indiquant si un utilisateur peut déplacer un WebPart contrôle entre WebPartZoneBase des zones.
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)
Attributes	Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés du contrôle. (Hérité de WebControl)
AuthorizationFilter	Obtient ou définit une chaîne arbitraire pour déterminer si un WebPart contrôle est autorisé à être ajouté à une page.
BackColor	Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web. (Hérité de WebControl)
BackImageUrl	Obtient ou définit l’URL de l’image d’arrière-plan pour le contrôle du panneau. (Hérité de Panel)
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control)
BorderColor	Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl)
BorderStyle	Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl)
BorderWidth	Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl)
CatalogIconImageUrl	Obtient ou définit l’URL d’une image qui représente un contrôle WebPart dans un catalogue de contrôles.
ChildControlsCreated	Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control)
ChromeState	Obtient ou définit si un contrôle de composant est dans un état réduit ou normal.
ChromeType	Obtient ou définit le type de bordure qui trame un contrôle WebPart.
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)
ConnectErrorMessage	Obtient un message d’erreur à afficher aux utilisateurs si des erreurs se produisent pendant le processus de connexion.
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 contient les contrôles enfants d’un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur. (Hérité de Part)
ControlStyle	Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ControlStyleCreated	Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
CssClass	Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl)
DataItemContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control)
DataKeysContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control)
DefaultButton	Obtient ou définit l’identificateur du bouton par défaut contenu dans le Panel contrôle. (Hérité de Panel)
Description	Obtient ou définit une brève expression qui résume ce que fait le contrôle de composant, à utiliser dans les info-bulles et les catalogues de contrôles de composants.
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control)
Direction	Obtient ou définit la direction horizontale que le contenu circule dans le contrôle.
DisplayTitle	Obtient une chaîne qui contient le texte de titre intégral réellement affiché dans la barre de titre d’une WebPart instance de contrôle.
Enabled	Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl)
EnableTheming	Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de WebControl)
EnableViewState	Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control)
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)
ExportMode	Obtient ou définit si toutes, certaines ou aucune des propriétés d’un WebPart contrôle ne peuvent être exportées.
Font	Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl)
ForeColor	Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl)
GroupingText	Obtient ou définit la légende du groupe de contrôles contenus dans le contrôle du panneau. (Hérité de Panel)
HasAttributes	Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl)
HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control)
HasSharedData	Obtient une valeur qui indique si un WebPart contrôle a des données de personnalisation partagées associées.
HasUserData	Obtient une valeur qui indique si un WebPart contrôle a des données de personnalisation utilisateur associées.
Height	Obtient ou définit la hauteur d’une zone.
HelpMode	Obtient ou définit le type d’interface utilisateur utilisé pour afficher le contenu d’aide d’un WebPart contrôle.
HelpUrl	Obtient ou définit l’URL vers un fichier d’aide pour un WebPart contrôle.
Hidden	Obtient ou définit une valeur indiquant si un WebPart contrôle est affiché sur une page Web.
HorizontalAlign	Obtient ou définit l’alignement horizontal du contenu dans le panneau. (Hérité de Panel)
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)
ImportErrorMessage	Obtient ou définit un message d’erreur utilisé si des erreurs se produisent lorsqu’un WebPart contrôle est importé.
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control)
IsClosed	Obtient une valeur qui indique si un WebPart contrôle est actuellement fermé sur une page de composants WebPart.
IsEnabled	Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl)
IsShared	Obtient une valeur qui indique si un WebPart contrôle est partagé, ce qui signifie qu’il est visible pour tous les utilisateurs d’une page de composants WebPart.
IsStandalone	Obtient une valeur qui indique si un WebPart contrôle est autonome, ce qui signifie qu’il n’est pas contenu dans une WebPartZoneBase zone.
IsStatic	Obtient une valeur qui indique si un WebPart contrôle est un contrôle statique, ce qui signifie que le contrôle est déclaré dans le balisage d’une page de composants WebPart et non ajouté à la page par programmation.
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)
ScrollBars	Obtient ou définit la visibilité et la position des barres de défilement dans un Panel contrôle. (Hérité de Panel)
Site	Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control)
SkinID	Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl)
Style	Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du contrôle serveur Web. (Hérité de WebControl)
Subtitle	Obtient une chaîne concaténée avec la valeur de propriété Title pour former un titre complet pour un WebPart contrôle.
SupportsDisabledAttribute	Obtient une valeur qui indique si le contrôle doit définir l’attribut `disabled` de l’élément HTML rendu sur « disabled » lorsque la propriété du IsEnabled contrôle est `false`. (Hérité de Panel)
TabIndex	Obtient ou définit l’index de tabulation du contrôle serveur Web. (Hérité de WebControl)
TagKey	Obtient la HtmlTextWriterTag valeur qui correspond à ce contrôle de serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
TagName	Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
TemplateControl	Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control)
TemplateSourceDirectory	Obtient le répertoire virtuel du Page UserControl ou qui contient le contrôle serveur actuel. (Hérité de Control)
Title	Obtient ou définit le titre d’un contrôle de composant.
TitleIconImageUrl	Obtient ou définit l’URL d’une image utilisée pour représenter un contrôle WebPart dans la barre de titre du contrôle.
TitleUrl	Obtient ou définit une URL pour obtenir des informations supplémentaires sur un WebPart contrôle.
ToolTip	Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl)
UniqueID	Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control)
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control)
Verbs	Obtient une collection de verbes personnalisés associés à un WebPart contrôle.
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)
WebBrowsableObject	Obtient une référence au WebPart contrôle pour lui permettre d’être modifié par des contrôles personnalisés EditorPart .
WebPartManager	Obtient une référence au WebPartManager contrôle associé à une WebPart instance de contrôle.
Width	Obtient ou définit la largeur du contrôle serveur Web.
Wrap	Obtient ou définit une valeur indiquant si le contenu est encapsulé dans le panneau. (Hérité de Panel)
Zone	Obtient la WebPartZoneBase zone qui contient actuellement un WebPart contrôle.
ZoneIndex	Obtient la position d’index d’un WebPart contrôle dans sa zone.

Méthodes

Nom	Description
AddAttributesToRender(HtmlTextWriter)	Ajoute des informations sur l’image d’arrière-plan, l’alignement, l’habillage et la direction à la liste des attributs à afficher. (Hérité de Panel)
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)
ApplyStyle(Style)	Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
ApplyStyleSheetSkin(Page)	Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control)
BeginRenderTracing(TextWriter, Object)	Commence le suivi au moment du design des données de rendu. (Hérité de Control)
BuildProfileTree(String, Boolean)	Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control)
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)
CopyBaseAttributes(WebControl)	Copie les propriétés non encapsulées par l’objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
CreateChildControls()	Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu. (Hérité de Control)
CreateControlCollection()	Crée un ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control)
CreateControlStyle()	Crée un objet de style utilisé en interne par le Panel contrôle pour implémenter toutes les propriétés associées au style. (Hérité de Panel)
CreateEditorParts()	Retourne une collection de contrôles personnalisés EditorPart qui peuvent être utilisés pour modifier un WebPart contrôle lorsqu’il est en mode édition.
DataBind()	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Part)
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)
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)
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)
GetDesignModeState()	Obtient les données au moment du design pour un contrôle. (Hérité de Control)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetRouteUrl(Object)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(String, Object)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié. (Hérité de Control)
HasControls()	Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control)
HasEvents()	Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control)
IsLiteralContent()	Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control)
LoadControlState(Object)	Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control)
LoadViewState(Object)	Restaure les informations d’état d’affichage à partir d’une requête précédente enregistrée avec la SaveViewState() méthode. (Hérité de WebControl)
MapPathSecure(String)	Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MergeStyle(Style)	Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)	Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page. (Hérité de Control)
OnClosing(EventArgs)	Permet aux classes dérivées de fournir une gestion personnalisée lorsqu’un WebPart contrôle est fermé sur une page de composants WebPart.
OnConnectModeChanged(EventArgs)	Permet aux classes dérivées de fournir une gestion personnalisée lorsqu’un WebPart contrôle commence ou termine le processus de connexion à d’autres contrôles.
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding. (Hérité de Control)
OnDeleting(EventArgs)	Permet aux classes dérivées de fournir une gestion personnalisée lorsqu’un WebPart contrôle est définitivement supprimé d’une page de composants WebPart.
OnEditModeChanged(EventArgs)	Permet aux classes dérivées de fournir une gestion personnalisée lorsqu’un WebPart contrôle entre ou quitte le mode d’édition.
OnInit(EventArgs)	Déclenche l’événement Init. (Hérité de Control)
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)
RaiseBubbleEvent(Object, EventArgs)	Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control)
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)	Restitue le contrôle au writer HTML spécifié. (Hérité de WebControl)
RenderBeginTag(HtmlTextWriter)	Restitue la balise d’ouverture HTML du Panel contrôle au writer spécifié. (Hérité de Panel)
RenderChildren(HtmlTextWriter)	Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control)
RenderContents(HtmlTextWriter)	Restitue le contenu du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control)
RenderControl(HtmlTextWriter)	Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control)
RenderEndTag(HtmlTextWriter)	Affiche la balise de fermeture HTML du Panel contrôle dans l’enregistreur spécifié. (Hérité de Panel)
ResolveAdapter()	Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control)
ResolveClientUrl(String)	Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control)
ResolveUrl(String)	Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control)
SaveControlState()	Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control)
SaveViewState()	Enregistre tout état modifié après l’appel de la TrackViewState() méthode. (Hérité de WebControl)
SetDesignModeState(IDictionary)	Définit les données au moment du design pour un contrôle. (Hérité de Control)
SetPersonalizationDirty()	Définit un indicateur indiquant que les données de personnalisation ont changé pour l’instance de contrôle actuelle WebPart .
SetPersonalizationDirty(Control)	Définit un indicateur indiquant que les données de personnalisation ont changé pour le contrôle serveur spécifié qui réside dans une WebPartZoneBase zone.
SetRenderMethodDelegate(RenderMethod)	Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control)
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
SetTraceData(Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TrackViewState()	Provoque le suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété de l’objet ViewState .

Événements

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

Implémentations d’interfaces explicites

Nom	Description
IAttributeAccessor.GetAttribute(String)	Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permet au développeur d’un concepteur d’un contrôle de composant composite de recréer les contrôles enfants du contrôle sur l’aire de conception. (Hérité de Part)
IControlBuilderAccessor.ControlBuilder	Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()	Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control)
IControlDesignerAccessor.UserData	Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control)
IDataBindingsAccessor.DataBindings	Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control)
IDataBindingsAccessor.HasDataBindings	Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control)
IExpressionsAccessor.Expressions	Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control)
IExpressionsAccessor.HasExpressions	Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)	Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control)

Méthodes d’extension

Nom	Description
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

Est-ce que cette page vous a été utile?