WebPart Classe

Définition

Sert de classe de base pour les contrôles WebPart ASP.NET personnalisés, en ajoutant aux fonctionnalités de la classe Part de base des propriétés d’interface utilisateur supplémentaires, la possibilité de créer des connexions et un 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
Dérivé
Implémente

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 de l’ensemble de contrôles 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, que vous le placez dans un sous-dossier Bin de votre application web et que vous 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 de WebPart nombreuses propriétés peuvent être affecté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 la fonctionnalité de composants WebPart, vous disposez de 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 (ou en les ajoutant par programmation à) un WebPartZone contrôle de zone, ce qui permet d’être encapsulés 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 des 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 , AllowConnect, AllowEdit, AllowHide, AllowMinimizeet AllowZoneChange spécifient si l’utilisateur d’une application web est autorisé à interagir avec le contrôle de composant de la manière indiquée par le nom de propriété donné. Les CatalogIconImageUrlpropriétés , ChromeState, ChromeType, HeightDescription, HelpUrlTitleIconImageUrlTitleTitleUrlHiddenet Width déterminent la taille, la visibilité, l’apparence et le contenu de prise en charge (tel qu’un titre et une description) d’un WebPart contrôle.

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

Notes

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 des composants WebPart.

Plusieurs autres propriétés importantes affectent les caractéristiques 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, lors d’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 le 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, plusieurs propriétés 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 opposition à un contrôle spécifique à l’utilisateur), ce qui signifie qu’il est visible par 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 (telle que WebPartZone). La valeur indique false que le contrôle se trouve à l’intérieur d’une zone et dispose donc de fonctionnalités 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 du cycle de vie du contrôle. Par exemple, les OnConnectModeChanged méthodes et OnEditModeChanged peuvent toutes deux ê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 qui dérivent de WebPart peuvent ajouter WebPartVerb des objets à la Verbs collection. Les verbes sont affichés dans un menu de 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 courantes de l’utilisateur, 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 tous les 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 d’édition sur un WebPart contrôle.

Constructeurs

WebPart()

Initialise la classe pour qu'elle soit utilisée par une instance de la classe héritée. Ce constructeur peut être appelé uniquement par une classe héritée.

Propriétés

AccessKey

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le 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 qui indique si un utilisateur final peut fermer un contrôle WebPart sur une page Web.

AllowConnect

Obtient ou définit une valeur qui indique d'autres contrôles peuvent créer des connexions avec le contrôle WebPart.

AllowEdit

Obtient ou définit une valeur qui indique si un utilisateur final peut modifier un contrôle WebPart par l'intermédiaire de l'interface utilisateur fournie par un ou plusieurs contrôles EditorPart.

AllowHide

Obtient ou définit une valeur qui indique si l'utilisateur final est autorisé à masquer un contrôle WebPart.

AllowMinimize

Obtient ou définit une valeur qui indique si l'utilisateur final peut réduire un contrôle WebPart.

AllowZoneChange

Obtient ou définit une valeur qui indique si un utilisateur peut déplacer un contrôle WebPart entre des zones WebPartZoneBase.

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)
Attributes

Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle.

(Hérité de WebControl)
AuthorizationFilter

Obtient ou définit une chaîne arbitraire pour déterminer si un contrôle WebPart 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 du contrôle du volet.

(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 des contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ChromeState

Obtient ou définit si un contrôle Part doit s'afficher dans un état réduit ou normal.

ChromeType

Obtient ou définit le type de bordure qui encadre un contrôle WebPart.

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)
ConnectErrorMessage

Permet l'affichage d'un message d'erreur pour les utilisateurs si des erreurs se produisent pendant le processus de connexion.

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 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 d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CssClass

Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client.

(Hérité de WebControl)
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)
DefaultButton

Obtient ou définit l'identificateur du bouton par défaut contenu dans le contrôle Panel.

(Hérité de Panel)
Description

Obtient ou définit une brève expression qui résume la fonction du contrôle Part, en vue d'une utilisation dans les info-bulles et les catalogues de contrôles Part.

DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.

(Hérité de Control)
Direction

Obtient ou définit le sens horizontal vers lequel le contenu est acheminé dans le contrôle.

DisplayTitle

Obtient une chaîne qui contient le texte de titre complet affiché dans la barre de titre d'une instance du contrôle WebPart.

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 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)
ExportMode

Obtient ou définit si toutes, certaines ou aucune des propriétés d'un contrôle WebPart, 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 qui figure dans le contrôle de 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 en cours possèdent des paramètres d'état d'affichage enregistrés.

(Hérité de Control)
HasSharedData

Obtient une valeur qui indique si un contrôle WebPart contient des données de personnalisation partagées qui lui sont associées.

HasUserData

Obtient une valeur qui indique si un contrôle WebPart contient des données de personnalisation de l'utilisateur qui lui sont 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 de l'aide pour un contrôle WebPart.

HelpUrl

Obtient ou définit l'URL d'un fichier d'aide pour un contrôle WebPart.

Hidden

Obtient ou définit une valeur qui indique si un contrôle WebPart s'affiche sur une page Web.

HorizontalAlign

Obtient ou définit l'alignement horizontal du contenu dans le volet.

(Hérité de Panel)
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)
ImportErrorMessage

Obtient ou définit un message d'erreur qui est utilisé si des erreurs se produisent durant l'importation d'un contrôle WebPart.

IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.

(Hérité de Control)
IsClosed

Obtient une valeur indiquant si un contrôle WebPart est actuellement fermé sur une page WebPart.

IsEnabled

Obtient une valeur indiquant si le contrôle est activé.

(Hérité de WebControl)
IsShared

Obtient une valeur qui indique si un contrôle WebPart est partagé, ce qui signifie qu'il est visible par tous les utilisateurs d'une page WebPart.

IsStandalone

Obtient une valeur qui indique si un contrôle WebPart est autonome, ce qui signifie qu'il n'est pas contenu dans une zone WebPartZoneBase.

IsStatic

Obtient une valeur qui indique si un contrôle WebPart est un contrôle statique, ce qui signifie que le contrôle est déclaré dans la balise d'une page WebPart et qu'il n'est pas ajouté par programme à la page.

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)
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)
ScrollBars

Obtient ou définit la visibilité et la position des barres de défilement dans un contrôle Panel.

(Hérité de Panel)
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 WebControl)
Style

Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web.

(Hérité de WebControl)
Subtitle

Obtient une chaîne concaténée avec la valeur de la propriété Title pour constituer le titre complet d'un contrôle WebPart.

SupportsDisabledAttribute

Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur 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 valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
TagName

Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des 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 ou du UserControl qui contient le contrôle serveur en cours.

(Hérité de Control)
Title

Obtient ou définit le titre du contrôle Part.

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 vers des informations supplémentaires relatives à un contrôle WebPart.

ToolTip

Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web.

(Hérité de WebControl)
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)
Verbs

Obtient une collection de verbes personnalisés associée à un contrôle WebPart.

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)
WebBrowsableObject

Obtient une référence au contrôle WebPart, pour permettre son édition par des contrôles EditorPart personnalisés.

WebPartManager

Obtient une référence au contrôle WebPartManager associé à une instance du contrôle WebPart.

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 volet.

(Hérité de Panel)
Zone

Obtient la zone WebPartZoneBase qui contient actuellement un contrôle WebPart.

ZoneIndex

Obtient la position d'index d'un contrôle WebPart dans sa zone.

Méthodes

AddAttributesToRender(HtmlTextWriter)

Ajoute des informations relatives à l'image d'arrière-plan, à l'alignement, au retour à la ligne et à la direction vers la liste des attributs à rendre.

(Hérité de Panel)
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)
ApplyStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des 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 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 null.

(Hérité de Control)
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)
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 des développeurs de contrôles.

(Hérité de WebControl)
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)
CreateControlStyle()

Crée un objet de style qui est utilisé de manière interne par le contrôle Panel pour implémenter toutes les propriétés associées au style.

(Hérité de Panel)
CreateEditorParts()

Retourne une collection de contrôles EditorPart personnalisés qui peuvent servir à modifier un contrôle WebPart lorsqu'il se trouve 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 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)
FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
Focus()

Affecte le focus d'entrée à 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()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
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)
IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.

(Hérité de Control)
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)
LoadViewState(Object)

Restaure les informations d'état d'affichage d'une demande précédente enregistrée avec la méthode SaveViewState().

(Hérité de WebControl)
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)
MergeStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
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)
OnClosing(EventArgs)

Permet aux classes dérivées de fournir une gestion personnalisée lorsqu'un contrôle WebPart est fermé sur une page WebPart.

OnConnectModeChanged(EventArgs)

Permet aux classes dérivées de fournir une gestion personnalisée lorsqu'un contrôle WebPart 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 contrôle WebPart est supprimé définitivement d'une page WebPart.

OnEditModeChanged(EventArgs)

Permet aux classes dérivées de fournir une gestion personnalisée lorsqu'un contrôle WebPart active ou désactive le mode é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 utilisé pour lire un fichier.

(Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.

(Hérité de Control)
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)

Génère le rendu du contrôle via le writer HTML spécifié.

(Hérité de WebControl)
RenderBeginTag(HtmlTextWriter)

Génère le rendu de la balise d'ouverture HTML du contrôle Panel via le writer spécifié.

(Hérité de Panel)
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)
RenderContents(HtmlTextWriter)

Génère le rendu du contenu du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
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)
RenderEndTag(HtmlTextWriter)

Génère le rendu de la balise de fermeture HTML du contrôle Panel via le writer spécifié.

(Hérité de Panel)
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 les états qui ont été modifiés après l’appel de la méthode TrackViewState().

(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 qui signale que les données de personnalisation ont changé pour l'instance de contrôle WebPart en cours.

SetPersonalizationDirty(Control)

Définit un indicateur qui spécifie que les données de personnalisation ont changé pour le contrôle serveur spécifié qui réside dans une zone WebPartZoneBase.

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)
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)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TrackViewState()

Force le contrôle à suivre les modifications apportées à son état d’affichage afin qu’elles puissent être stockées dans la propriété ViewState.

Événements

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)
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)

Obtient un attribut du contrôle Web avec le nom spécifié.

(Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Affecte au nom et à la valeur spécifiés un attribut du contrôle Web.

(Hérité de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Permet au développeur d'un concepteur de contrôle Part 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

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é.

S’applique à

Voir aussi