WebZone 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 tous les contrôles qui agissent en tant que conteneurs pour les contrôles serveur (y compris les contrôles WebPart, les contrôles serveur et les contrôles utilisateur) dans les applications De composants WebPart Part .

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl

[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl

[<System.ComponentModel.Bindable(false)>]
type WebZone = class
    inherit CompositeControl

Public MustInherit Class WebZone
Inherits CompositeControl

Héritage: Object

Control

WebControl

CompositeControl
WebZone

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

System.Web.UI.WebControls.WebParts.WebPartZoneBase

Attributs: BindableAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la WebZone classe.

La première partie de l’exemple de code montre deux contrôles personnalisés qui dérivent de la WebPart classe. 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. 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 CalendarWebPart : WebPart
  {
    Calendar _calendar;

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

    protected override void CreateChildControls()
    {
      Controls.Clear();
      _calendar = new Calendar();
      _calendar.Caption = "My Calendar";
      this.Controls.Add(_calendar);
      ChildControlsCreated = true;
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class LinksWebPart : WebPart
  {
    Literal _literal;
    const string _literalText = @"
      <table>
      <tr>
        <td><a href='http://msdn.microsoft.com'>MSDN</a></td>
      </tr>
      <tr>
        <td><a href='http://msn.microsoft.com'>MSN</a></td>
      </tr>
      <tr>
        <td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
      </tr>
      </table>";

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

    protected override void CreateChildControls()
    {
      Controls.Clear();

      _literal = new Literal();
      _literal.Text = _literalText;
      this.Controls.Add(_literal);

      ChildControlsCreated = true;
    }
  }
}

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 CalendarWebPart
  Inherits WebPart
  Private _calendar As Calendar

  Public Sub New()
    Me.AllowClose = False

  End Sub

  Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      _calendar = New Calendar()
      _calendar.Caption = "My Calendar"
      Me.Controls.Add(_calendar)
      ChildControlsCreated = True
  
  End Sub 
  
End Class 

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class LinksWebPart
    Inherits WebPart
    Private _literal As Literal
    Private Const _literalText As String = _
      "<table>" & _
      "<tr>" & _
      "<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
      "</tr>" & _
      "</table>"

    Public Sub New()
      Me.AllowClose = False

    End Sub


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      _literal = New Literal()
      _literal.Text = _literalText
      Me.Controls.Add(_literal)

      ChildControlsCreated = True

    End Sub
  End Class

End Namespace

La deuxième partie de l’exemple de code montre une page Web qui héberge les WebPart contrôles. Notez que le balisage déclaratif contient deux WebPartZone contrôles, un CatalogZone contrôle et un EditorZone contrôle.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<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" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" 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:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<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" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" 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:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

Vous pouvez charger la page dans un navigateur et basculer entre les différents modes d’affichage de page pour voir comment les différentes zones se comportent. Pour plus d’informations sur les modes d’affichage et permettre aux utilisateurs de basculer entre eux, consultez Procédure pas à pas : modification des modes d’affichage sur une page de composants WebPart.

Remarques

Une zone de composants WebPart est une région définie qui contient des contrôles serveur sur une page Web et fournit une interface utilisateur cohérente, une disposition et un rendu pour les contrôles contenus. Les zones sont rendues dans un navigateur sous forme de tables HTML.

La WebZone classe est la classe de base pour toutes les zones de composants WebPart. Un contrôle de zone est un contrôle composite conçu pour contenir d’autres contrôles. Par conséquent, la WebZone classe hérite de la CompositeControl classe. Avec le WebPartManager contrôle et Part les contrôles (ou d’autres contrôles utilisateur ou serveur qui peuvent être placés dans des zones), les contrôles de zone dérivés de la WebZone classe de base forment les blocs de construction essentiels d’une application WebPart.

Un rôle essentiel des zones de composants WebPart consiste à activer les fonctionnalités complètes des composants WebPart pour les contrôles qu’ils contiennent. Chaque page de composants WebPart contient au moins une zone, et une zone peut contenir zéro ou plusieurs contrôles de composants. Les zones sont requises pour les fonctionnalités des composants WebPart. Sans zones, même les contrôles dérivés de la WebPart classe peuvent avoir très peu de fonctionnalités de composants WebPart. À l’inverse, en raison de la conception de l’ensemble de contrôles De composants WebPart, vous pouvez placer des contrôles de ASP.NET ordinaires, des contrôles serveur ou des contrôles utilisateur dans une WebPartZoneBase zone (qui dérive de WebZone), et en raison d’être dans la zone, ces contrôles serveur ordinaires permettent d’agir en tant que WebPart contrôles au moment de l’exécution. Pour plus d’informations, consultez la documentation de la GenericWebPart classe.

Note

Il est possible d’ajouter Part ou WebPart de contrôler une page en dehors d’une zone, mais dans ce cas, ils fonctionnent simplement en tant que contrôles serveur ordinaires.

Il existe deux grandes catégories de zones dans le jeu de contrôles Composants WebPart, qui héritent toutes de la classe de base WebZone .

WebPartZoneBase zones. Ces contrôles contiennent WebPart (et d’autres contrôles serveur et utilisateur) et forment l’interface utilisateur principale des pages de composants WebPart que les utilisateurs interagissent avec la plupart du temps.
ToolZone zones. Ces zones fournissent des vues spéciales d’une page de composants WebPart qui permettent aux utilisateurs de modifier (personnaliser) le contenu, la disposition, l’apparence, le comportement et les propriétés des contrôles contenus dans WebPartZoneBase les zones d’une page composants WebPart. Par exemple, une CatalogZoneBase zone est une ToolZone zone qui fournit une vue catalogue d’une page, ce qui permet aux utilisateurs d’ajouter et de supprimer des contrôles serveur. Une EditorZoneBase zone est un autre type qui ToolZone fournit une vue d’édition d’une page, permettant aux utilisateurs de modifier et de modifier la mise en page, ainsi que les propriétés, l’apparence et le comportement des contrôles.

Chaque zone du jeu de contrôles Composants WebPart est conçue pour contenir un type de contrôle correspondant dérivé de la Part classe, avec les contrôles de composant servant de contenu principal et d’interface utilisateur principale de la zone. Les types de zones dans le jeu de contrôles Composants WebPart, ainsi que les types de contrôles de composants correspondants qu’ils contiennent, sont indiqués dans le tableau suivant.

Type de contrôle de composant	Type de zone
WebPart (et les contrôles serveur et utilisateur, qui sont encapsulés avec une GenericWebPart exécution au moment de l’exécution)	WebPartZone (la classe de base est WebPartZoneBase )
EditorPart (plusieurs contrôles dérivés sont fournis avec le jeu de contrôles Composants WebPart, et des contrôles personnalisés EditorPart peuvent être développés)	EditorZone (la classe de base est EditorZoneBase )
CatalogPart (plusieurs contrôles dérivés sont fournis avec le jeu de contrôles Composants WebPart, et des contrôles personnalisés CatalogPart peuvent être développés)	CatalogZone (la classe de base est CatalogZoneBase )
WebPartConnection (Les contrôles de connexion sont uniques dans le fait qu’ils ne font pas partie des contrôles qui héritent de la classe de base)	ConnectionsZone (hérite directement de ToolZone )

Toutes les zones du contrôle WebPart ont des éléments d’interface utilisateur de base courants qu’ils héritent de la classe de base WebZone . Tous ces éléments ne sont pas visibles sur chaque zone, mais chaque type de zone est capable d’avoir ces éléments d’interface utilisateur communs liés à la zone, comme décrit dans le tableau suivant.

Section Zone	Description
Header	Section supérieure d’une zone. Il inclut le texte d’en-tête, qui peut inclure un titre pour la zone ; attributs de style (tels qu’une bordure ou une couleur d’arrière-plan) qui distinguent l’en-tête ; et verbes au niveau de la zone (représentés par des boutons, des liens hypertexte ou des images) que les utilisateurs peuvent cliquer pour effectuer des actions d’interface utilisateur qui s’appliquent à toute la zone, telles que la fermeture d’une zone. Plusieurs WebZone propriétés, telles que HasHeader, HeaderStyleet HeaderText, sont liées à la zone d’en-tête d’une zone. S’il existe des verbes au niveau de la zone, les propriétés et VerbStyle les VerbButtonType propriétés s’appliquent à celles-ci. Notez que ces deux propriétés de verbe s’appliquent uniquement aux verbes au niveau de la zone, et non aux verbes dans les contrôles de partie individuels contenus dans la zone. Les en-têtes ne sont pas présents dans chaque type de zone ; ils apparaissent généralement dans ToolZone des zones où il est nécessaire d’avoir une zone d’en-tête commune avec du texte et un verbe, tel qu’un verbe proche.
Corps	Section principale du contenu d’une zone. Chaque zone dérivée d’une WebZone section de corps. Pour tous les types de zones dans le jeu de contrôles Composants WebPart, le corps de la zone contient le type désigné de Part contrôles (ou d’autres contrôles serveur) qui correspondent à un type de zone, comme indiqué dans le tableau précédent. Différents membres de la WebZone classe affectent le contenu de la section du corps, par exemple les propriétés, les propriétés et les BackImageUrlpropriétésPartChromeType PartChromeStyle PartStyle. Si la section du corps est vide, le EmptyZoneText message peut être affiché dans certaines situations.
Chrome	Éléments d’interface utilisateur courants rendus pour chaque contrôle de partie dans une zone. Il s’agit d’une discussion sur les attributs de style qui s’appliquent à la zone elle-même ; Chrome s’applique spécifiquement aux contrôles de composants contenus. Chrome inclut des verbes, des bordures et d’autres attributs de style, tels que la couleur d’arrière-plan ou le style de police du texte de titre, pour les contrôles de partie d’une zone. Une zone détermine les détails chrome à l’aide d’un seul objet chrome approprié au type de contrôles qu’il contient (par exemple, un CatalogPartChrome objet pour un contrôle qui contient des CatalogZone CatalogPart contrôles). Cet objet chrome unique gère les détails chrome et le rendu de tous les contrôles de partie dans la zone. Cela permet aux développeurs de créer des zones dans lesquelles ils peuvent spécifier une apparence cohérente et commune pour tous les contrôles de partie. Certaines propriétés liées au chrome pour les contrôles de partie d’une zone incluent les propriétés, les PartChromeType PartStylepropriétés et PartTitleStyle les PartChromeStylepropriétés. Notez que la plupart des propriétés liées au chrome, y compris une propriété spécifique pour référencer l’objet chrome pour un type particulier de zone, ne sont pas implémentées dans la classe de base WebZone . Au lieu de cela, la plupart des fonctionnalités spécifiques au chrome des zones sont implémentées sur des types de zones spécifiques en fonction des besoins uniques de leurs contrôles de partie. Consultez les rubriques pour chaque type de zone répertorié dans le tableau précédent de cette rubrique.
Contrôles de partie	Contrôles qui résident dans la section corps d’une zone. Chaque zone qui hérite de la WebZone classe contient dans sa section de corps un ou plusieurs contrôles de partie d’un type correspondant, comme indiqué dans le tableau précédent de cette rubrique. Ces contrôles de composant forment l’interface utilisateur principale des applications de composants WebPart. La plupart des types de zone qui dérivent d’une WebZone propriété de collection qui leur permet de référencer tous leurs contrôles de composants contenus, tels que la WebParts propriété sur la WebPartZoneBase classe et la EditorParts propriété sur la EditorZoneBase classe.
Pied de page	Section inférieure d’une zone. Comme la section d’en-tête, elle n’est pas présente dans chaque type de zone, mais se produit généralement dans ToolZone les zones. Le contenu typique d’une section de pied de page est des verbes tels qu’un verbe ok ou un verbe appliquer, qui apparaissent dans le pied de page des EditorZoneBase zones. Certaines propriétés liées à la section pied de page incluent les propriétés, FooterStyleles VerbButtonTypepropriétés et VerbStyle les HasFooterpropriétés.

La plupart des propriétés de la WebZone classe sont décrites dans le tableau précédent qui décrit les éléments communs de l’interface utilisateur des zones. La WebZone classe a également plusieurs méthodes relatives à son rôle de rendu du contenu. Les RenderBodyméthodes et les RenderFooter RenderHeader méthodes RenderContentspeuvent toutes être substituées pour fournir un contrôle programmatique sur le rendu de chaque section spécifique d’une zone. Par exemple, si vous souhaitez personnaliser le rendu de toutes les sections de pied de page des zones de catalogue dans votre application, vous pouvez hériter de la CatalogZoneBase classe, remplacer la RenderFooter méthode héritée de WebZone, et modifier le rendu de la section pied de page.

Notes pour les responsables de l’implémentation

Vous devez rarement hériter directement de la WebZone classe pour développer des zones de composants WebPart personnalisées. Le jeu de contrôles Composants WebPart contient les zones spécialisées répertoriées ci-dessus dans la section Remarques, et généralement vous pouvez dériver de l’un d’eux pour ajouter un comportement personnalisé à une zone. Si vous décidez d’hériter directement de la WebZone classe, vous devez remplacer un certain nombre de propriétés et de méthodes (consultez la documentation relative aux membres de la WebZone classe). Vous devez également créer un contrôle personnalisé, éventuellement un contrôle personnalisé WebPartManager WebPartDisplayMode pour créer un mode d’affichage unique dans lequel afficher votre zone et d’autres personnalisations pour que votre zone fonctionne dans le jeu de contrôles Composants WebPart.

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)
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)
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 sur une image d’arrière-plan pour une zone.
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)
ChildControlsCreated	Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control)
ClientID	Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control)
ClientIDMode	Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété. (Hérité de Control)
ClientIDSeparator	Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control)
Context	Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control)
Controls	Obtient un ControlCollection objet qui représente les contrôles enfants dans un CompositeControl. (Hérité de CompositeControl)
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)
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control)
EmptyZoneText	Obtient ou définit un message qui s’affiche lorsqu’une zone ne contient aucun contrôle.
EmptyZoneTextStyle	Obtient les attributs de style pour le texte de l’espace réservé dans une zone vide.
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)
ErrorStyle	Obtient les attributs de style pour le rendu du message d’erreur qui s’affiche si un WebPart contrôle ne peut pas être chargé ou créé.
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)
Font	Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl)
FooterStyle	Obtient les attributs de style pour le contenu de la zone de pied de page d’une zone.
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)
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)
HasFooter	Obtient une valeur indiquant si une zone a une zone de pied de page.
HasHeader	Obtient une valeur indiquant si une zone a une zone d’en-tête.
HeaderStyle	Obtient les attributs de style pour le contenu de la zone d’en-tête d’une zone.
HeaderText	Obtient ou définit le texte de la zone d’en-tête d’une zone.
Height	Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl)
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)
IsEnabled	Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl)
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)
Padding	Obtient ou définit les attributs de remplissage de cellule sur le tableau qui contient les WebPart contrôles d’une zone.
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)
PartChromePadding	Obtient ou définit la distance entre le contenu d’un WebPart contrôle et la bordure du contrôle.
PartChromeStyle	Obtient les caractéristiques de style qui s’appliquent aux bordures des contrôles De composants WebPart contenus dans une zone.
PartChromeType	Obtient ou définit le type de bordure qui trame les contrôles de composants WebPart contenus dans une zone.
PartStyle	Obtient les caractéristiques de style qui s’appliquent à la bordure et au contenu de chaque contrôle WebPart contenu par une zone.
PartTitleStyle	Obtient les attributs de style pour le contenu de la barre de titre pour chaque contrôle WebPart contenu dans une zone.
RenderClientScript	Obtient une valeur qui indique s’il faut afficher le script client sur une page de composants WebPart.
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control)
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)
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 CompositeControl)
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.
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)
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)
VerbButtonType	Obtient ou définit le type de bouton utilisé pour représenter des verbes dans une zone.
VerbStyle	Obtient les attributs de style pour les verbes d’interface utilisateur associés aux contrôles WebPart dans une zone.
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)
WebPartManager	Obtient une référence au WebPartManager contrôle associé à une WebZone instance de contrôle sur une page de composants WebPart.
Width	Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl)

Méthodes

Nom	Description
AddAttributesToRender(HtmlTextWriter)	Ajoute des attributs et des styles HTML qui doivent être rendus dans le fichier spécifié HtmlTextWriterTag. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
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 l’objet de style utilisé en interne par la WebControl classe pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
DataBind()	Lie une source de données aux contrôles enfants et à CompositeControl tous ses contrôles enfants. (Hérité de CompositeControl)
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)
GetEffectiveChromeType(Part)	Retourne la valeur actuelle réelle PartChromeType ou effective d’un WebPart contrôle, en fonction de la PartChromeType propriété de la zone et du mode d’affichage actuel de la page Composants WebPart.
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)	Charge les informations d’état précédemment enregistrées pour une zone.
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)
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding. (Hérité de Control)
OnInit(EventArgs)	Déclenche l’événement Init.
OnLoad(EventArgs)	Déclenche l’événement Load. (Hérité de Control)
OnPreRender(EventArgs)	Déclenche l’événement PreRender.
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)
RecreateChildControls()	Recrée les contrôles enfants dans un contrôle dérivé de CompositeControl. (Hérité de CompositeControl)
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)	Écrit le CompositeControl contenu dans l’objet spécifié HtmlTextWriter , pour l’affichage sur le client. (Hérité de CompositeControl)
RenderBeginTag(HtmlTextWriter)	Affiche la balise HTML ouvrante du contrôle de zone sur l’objet spécifié HtmlTextWriter .
RenderBody(HtmlTextWriter)	Remplace le rendu du corps d’un contrôle de zone.
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)	Affiche l’intégralité du contenu d’un contrôle de zone entre les balises de début et de fin sur l’objet spécifié HtmlTextWriter .
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 contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl)
RenderFooter(HtmlTextWriter)	Remplace le rendu du pied de page d’un contrôle de zone.
RenderHeader(HtmlTextWriter)	Remplace le rendu de l’en-tête d’un contrôle de zone.
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 qui se sont produites après la publication d’une page sur le serveur.
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)
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()	Suit les modifications apportées à l’état d’affichage d’un contrôle de zone.

É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 à un concepteur de recréer la collection de contrôles enfants du contrôle composite dans l’environnement au moment du design. (Hérité de CompositeControl)
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

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