WebZone Class

Definition

Sert de classe de base pour tous les contrôles qui jouent le rôle de conteneurs pour les contrôles serveur (notamment les contrôles Part WebPart, les contrôles serveur et les contrôles utilisateur) dans les applications WebPart.Serves as the base class for all controls that act as containers for server controls (including Web Parts Part controls, server controls, and user controls) in Web Parts applications.

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl
[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl
type WebZone = class
    inherit CompositeControl
Public MustInherit Class WebZone
Inherits CompositeControl
Inheritance
Derived
Attributes

Examples

L’exemple de code suivant illustre l’utilisation de la classe WebZone.The following code example demonstrates the use of the WebZone class.

La première partie de l’exemple de code montre deux contrôles personnalisés qui dérivent de la classe WebPart.The first part of the code example shows two custom controls that derive from the WebPart class. Pour que l’exemple de code s’exécute, vous devez compiler ce code source.For the code example to run, you must compile this source code. Vous pouvez la compiler explicitement et placer l’assembly résultant dans le dossier bin de votre site Web ou le Global Assembly Cache.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the 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.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. 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é.For a walkthrough that demonstrates both methods of compiling, see Walkthrough: Developing and Using a Custom Web Server Control.

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 contrôles WebPart.The second part of the code example shows a Web page that hosts the WebPart controls. Notez que le balisage déclaratif contient deux contrôles WebPartZone, un contrôle CatalogZone et un contrôle EditorZone.Notice that the declarative markup contains two WebPartZone controls, a CatalogZone control and an EditorZone control.

<%@ 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 la page pour voir comment les différentes zones se comportent.You can load the page in a browser and switch among the various page display modes to see how the different zones behave. Pour plus d’informations sur les modes d’affichage et l’activation des utilisateurs pour basculer entre eux, consultez procédure pas à pas : modification des modes d’affichage sur une page de composants WebPart.For more information on display modes and enabling users to switch among them, see Walkthrough: Changing Display Modes on a Web Parts Page.

Remarks

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, une mise en page et un rendu cohérents pour les contrôles contenus.A Web Parts zone is a defined region that contains server controls on a Web page, and provides a consistent user interface (UI), layout, and rendering for the contained controls. Les zones sont rendues dans un navigateur sous forme de tableaux HTML.Zones are rendered in a browser as HTML tables.

La classe WebZone est la classe de base pour toutes les zones de composants WebPart.The WebZone class is the base class for all Web Parts zones. Un contrôle de zone est un contrôle composite conçu pour contenir d’autres contrôles. par conséquent, la classe WebZone hérite de la classe CompositeControl.A zone control is a composite control designed to contain other controls, hence the WebZone class inherits from the CompositeControl class. Avec le contrôle WebPartManager et les contrôles Part (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 classe de base WebZone forment les blocs de construction essentiels d’une application composants WebPart.Together with the WebPartManager control and Part controls (or other user or server controls that can be placed in zones), zone controls derived from the WebZone base class form the essential building blocks of a Web Parts application.

L’un des rôles critiques des zones de composants WebPart consiste à activer la fonctionnalité de composants WebPart complète pour les contrôles qu’ils contiennent.A critical role of Web Parts zones is to enable full Web Parts functionality for the controls they contain. Chaque page composants WebPart contient au moins une zone, et une zone peut contenir zéro ou plusieurs contrôles part.Every Web Parts page contains at least one zone, and a zone can contain zero or more part controls. Les zones sont requises pour les fonctionnalités de composants WebPart.Zones are required for Web Parts functionality. Sans zones, même les contrôles qui dérivent de la classe WebPart peuvent avoir très peu de fonctionnalités composants WebPart.Without zones, even controls that derive from the WebPart class can have very little Web Parts functionality. À l’inverse, en raison de la conception du jeu de contrôles composants WebPart, vous pouvez placer des contrôles ASP.NET ordinaires, des contrôles serveur ou des contrôles utilisateur dans une zone WebPartZoneBase (qui dérive de WebZone) et, en vertu de la zone, ces contrôles serveur ordinaires sont activés pour agir en tant que WebPart contrôles au moment de l’exécution.Conversely, because of the design of the Web Parts control set, you can place ordinary ASP.NET controls, server controls, or user controls into a WebPartZoneBase zone (which derives from WebZone), and by virtue of being in the zone, these ordinary server controls are enable to act as WebPart controls at run time. Pour plus d’informations, consultez la documentation de la classe GenericWebPart.For details, see the documentation for the GenericWebPart class.

Note

Il est possible d’ajouter des contrôles Part ou WebPart à une page en dehors d’une zone, mais dans ce cas, ils fonctionnent simplement comme des contrôles serveur ordinaires.It is possible to add Part or WebPart controls to a page outside of a zone, but in that case they simply function as ordinary server controls.

Il existe deux grandes catégories de zones dans le jeu de contrôles composants WebPart, qui héritent toutes de la classe de WebZone de base.There are two broad categories of zones in the Web Parts control set, all of which inherit from the base WebZone class.

  • zones de WebPartZoneBase.WebPartZoneBase zones. Celles-ci contiennent des contrôles WebPart (et d’autres serveurs et utilisateurs) et constituent l’interface utilisateur principale de composants WebPart pages que les utilisateurs interagissent avec la plupart du temps.These contain WebPart (and other server and user) controls, and form the primary UI of Web Parts pages that users interact with most of the time.

  • zones de ToolZone.ToolZone zones. Ces zones fournissent des affichages particuliers 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 les zones de WebPartZoneBase sur une page composants WebPart.These zones provide special views of a Web Parts page that enable users to modify (personalize) the content, layout, appearance, behavior, and properties of controls contained in WebPartZoneBase zones on a Web Parts page. Par exemple, une zone de CatalogZoneBase est une ToolZone qui fournit un affichage catalogue d’une page, ce qui permet aux utilisateurs d’ajouter et de supprimer des contrôles serveur.For example, a CatalogZoneBase zone is a ToolZone that provides a catalog view of a page, enabling users to add and remove server controls. Une zone de EditorZoneBase est un autre type de ToolZone qui fournit un affichage de modification d’une page, permettant aux utilisateurs de modifier et de modifier la disposition de la page, ainsi que les propriétés, l’apparence et le comportement des contrôles.An EditorZoneBase zone is another type of ToolZone that provides an editing view of a page, enabling users to modify and edit the layout of the page, along with the properties, appearance, and behavior of the controls.

Chaque zone dans le jeu de contrôles composants WebPart est conçue pour contenir un type de contrôle correspondant dérivé de la classe Part, avec les contrôles part servant de contenu principal et l’interface utilisateur principale de la zone.Each zone in the Web Parts control set is designed to contain a corresponding type of control derived from the Part class, with the part controls serving as the main content and primary UI of the zone. Les types de zone dans le jeu de contrôles composants WebPart, ainsi que les types correspondants des contrôles de partie qu’ils contiennent, sont présentés dans le tableau suivant.Zone types in the Web Parts control set, along with the corresponding types of part controls they contain, are shown in the following table.

Type de contrôle partPart control type Type de zoneZone type
WebPart (et les contrôles serveur et utilisateur, encapsulés avec un GenericWebPart au moment de l’exécution)WebPart (and server and user controls, which are wrapped with a GenericWebPart at run time) WebPartZone (la classe de base est WebPartZoneBase)WebPartZone (the base class is WebPartZoneBase )
EditorPart (plusieurs contrôles dérivés sont fournis avec le jeu de contrôles composants WebPart, et les contrôles EditorPart personnalisés peuvent être développés)EditorPart (several derived controls are provided with the Web Parts control set, and custom EditorPart controls can be developed) EditorZone (la classe de base est EditorZoneBase)EditorZone (the base class is EditorZoneBase )
CatalogPart (plusieurs contrôles dérivés sont fournis avec le jeu de contrôles composants WebPart, et les contrôles CatalogPart personnalisés peuvent être développés)CatalogPart (several derived controls are provided with the Web Parts control set, and custom CatalogPart controls can be developed) CatalogZone (la classe de base est CatalogZoneBase)CatalogZone (the base class is CatalogZoneBase )
WebPartConnection (les contrôles de connexion sont uniques en ce qu’ils ne font pas partie des contrôles qui héritent de la classe de base)WebPartConnection (connection controls are unique in that they are not part controls that inherit from the base class) ConnectionsZone (hérite directement de ToolZone)ConnectionsZone (inherits directly from ToolZone )

Toutes les zones du contrôle composants WebPart ont des éléments d’interface utilisateur communs de base dont ils héritent de la classe de WebZone de base.All zones in the Web Parts control have basic, common user interface elements that they inherit from the base WebZone class. Tous ces éléments ne sont pas visibles dans chaque zone, mais chaque type de zone peut avoir ces éléments d’interface utilisateur communs, tels que décrits dans le tableau suivant.Not all these elements are visible on every zone, but each zone type is capable of having these common, zone-related UI elements, as described in the following table.

Section zoneZone section DescriptionDescription
En-têteHeader Section supérieure d’une zone.The top section of a zone. Il inclut le texte d’en-tête, qui peut inclure un titre pour la zone ; attributs de style (par exemple, une bordure ou une couleur d’arrière-plan) qui distinguent l’en-tête ; et les verbes au niveau de la zone (représentés par des boutons, des liens hypertexte ou des images) sur lesquels les utilisateurs peuvent cliquer pour exécuter des actions d’interface utilisateur qui s’appliquent à la zone entière, telles que la fermeture d’une zone.It includes header text, which can include a title for the zone; style attributes (such as a border or background color) that distinguish the header; and zone-level verbs (represented by buttons, hyperlinks, or images) that users can click to perform UI actions that apply to the entire zone, such as closing a zone. Plusieurs propriétés de WebZone, telles que HasHeader, HeaderStyleet HeaderText, sont liées à la zone d’en-tête d’une zone.Several WebZone properties, such as HasHeader, HeaderStyle, and HeaderText, relate to the header area of a zone. S’il existe des verbes au niveau de la zone dans la zone, les propriétés VerbButtonType et VerbStyle s’appliquent à eux.If there are zone-level verbs in the zone, the VerbButtonType and VerbStyle properties apply to them. Notez que ces deux propriétés de verbe s’appliquent uniquement aux verbes au niveau de la zone, et non aux verbes des contrôles part individuels contenus dans la zone.Note that these two verb properties apply to zone-level verbs only, not to verbs in the individual part controls contained in the zone. Les en-têtes ne sont pas présents dans chaque type de zone ; en règle générale, elles apparaissent dans ToolZone 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 de fermeture.Headers are not present in every type of zone; typically they appear in ToolZone zones where there is a need to have a common header area with text and a verb, such as a close verb.
CorpsBody Section de contenu principal d’une zone.The main contents section of a zone. Chaque zone qui dérive de WebZone a une section de corps.Every zone that derives from WebZone has a body section. 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 contrôles Part (ou d’autres contrôles serveur) qui correspondent à un type de zone, comme indiqué dans le tableau précédent.For all types of zones in the Web Parts control set, the body of the zone contains the designated type of Part controls (or other server controls) that correspond to a zone type, as indicated in the previous table. Les différents membres de la classe WebZone affectent le contenu de la section body, comme les propriétés BackImageUrl, PartChromeStyle, PartChromeTypeet PartStyle.Various members of the WebZone class affect the contents of the body section, such as the BackImageUrl, PartChromeStyle, PartChromeType, and PartStyle properties. Si la section du corps est vide, le message de EmptyZoneText peut s’afficher dans certaines situations.If the body section is empty, the EmptyZoneText message can be displayed in certain situations.
ChromeChrome Éléments d’interface utilisateur communs rendus pour chaque contrôle part dans une zone.The common UI elements rendered for each part control in a zone. Cela est différent d’une discussion sur les attributs de style qui s’appliquent à la zone elle-même. chrome s’applique spécifiquement aux contrôles Part contenus.This is distinct from a discussion of style attributes that apply to the zone itself; chrome applies specifically to the contained part controls. Chrome comprend 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 du titre, pour les contrôles de partie d’une zone.Chrome includes verbs, borders, and other style attributes such as background color, or font style of the title text, for a zone's part controls. Une zone détermine les détails du chrome en utilisant un seul objet chrome approprié au type de contrôles part qu’il contient (par exemple, un objet CatalogPartChrome pour un CatalogZone qui contient des contrôles CatalogPart).A zone determines the chrome details by using a single chrome object appropriate to the type of part controls it contains (for example, a CatalogPartChrome object for a CatalogZone that contains CatalogPart controls). Cet objet chrome unique gère les détails du chrome et le rendu de tous les contrôles part dans la zone.This single chrome object handles the chrome details and the rendering for all the part controls in the 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 part.This enables developers to create zones in which they can specify a consistent, common look and feel for all the part controls. Certaines propriétés associées au chrome pour les contrôles part d’une zone incluent les propriétés PartChromeStyle, PartChromeType, PartStyleet PartTitleStyle.Some properties that relate to the chrome for a zone's part controls include the PartChromeStyle, PartChromeType, PartStyle, and PartTitleStyle properties. Notez que la plupart des propriétés liées au chrome, y compris une propriété spécifique qui référence l’objet chrome pour un type particulier de zone, ne sont pas implémentées dans la classe de base WebZone.Note that most chrome-related properties, including a specific property to reference the chrome object for a particular type of zone, are not implemented in the base WebZone class. Au lieu de cela, la plupart des fonctionnalités spécifiques au chrome sont implémentées sur des types de zones spécifiques, en fonction des besoins uniques de leurs contrôles part.Instead, most chrome-specific features of zones are implemented on specific zone types as appropriate to the unique needs of their part controls. Consultez les rubriques pour chaque type de zone indiqué dans le tableau précédent de cette rubrique.See the topics for each zone type listed in the previous table of this topic.
Contrôles partPart Controls Contrôles qui résident dans la section de corps d’une zone.The controls that reside in the body section of a zone. Chaque zone qui hérite de la classe WebZone contient dans sa section body un ou plusieurs contrôles part d’un type correspondant, comme indiqué dans le tableau précédent de cette rubrique.Every zone that inherits from the WebZone class contains in its body section one or more part controls of a corresponding type, as shown in the previous table in this topic. Ces contrôles part forment l’interface utilisateur principale des applications composants WebPart.These part controls form the main UI of Web Parts applications. La plupart des types de zone qui dérivent de WebZone avoir une propriété de collection qui leur permet de référencer tous les contrôles de parties qu’ils contiennent, tels que la propriété WebParts sur la classe WebPartZoneBase, et la propriété EditorParts sur la classe EditorZoneBase.Most zone types that derive from WebZone have a collection property that enables them to reference all their contained part controls, such as the WebParts property on the WebPartZoneBase class, and the EditorParts property on the EditorZoneBase class.
Pied de pageFooter Section inférieure d’une zone.The bottom section of a 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 les zones de ToolZone.Like the header section, it is not present in every type of zone, but usually occurs in ToolZone zones. Le contenu typique d’une section de pied de page est un verbe, tel qu’un verbe OK ou un verbe Apply, qui apparaît dans le pied de page de EditorZoneBase zones.Typical contents of a footer section are verbs such as an ok verb or an apply verb, which appear in the footer of EditorZoneBase zones. Certaines propriétés relatives à la section de pied de page incluent les propriétés HasFooter, FooterStyle, VerbButtonTypeet VerbStyle.Some properties that relate to the footer section include the HasFooter, FooterStyle, VerbButtonType, and VerbStyle properties.

La plupart des propriétés de la classe WebZone sont abordées dans le tableau précédent qui décrit les éléments d’interface utilisateur courants des zones.Most of the WebZone class's properties are discussed in the preceding table that describes the common UI elements of zones. La classe WebZone possède également plusieurs méthodes relatives à son rôle de rendu du contenu.The WebZone class also has several methods relating to its role of rendering content. Les méthodes RenderBody, RenderContents, RenderFooteret RenderHeader peuvent toutes être substituées pour fournir un contrôle par programmation sur le rendu de chaque section spécifique d’une zone.The RenderBody, RenderContents, RenderFooter, and RenderHeader methods can all be overridden to provide programmatic control over the rendering of each specific section of a 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 classe CatalogZoneBase, substituer la méthode RenderFooter héritée de WebZoneet modifier le rendu de la section de pied de page.For example, if you want to customize the rendering of all the footer sections of catalog zones in your application, you could inherit from the CatalogZoneBase class, override the RenderFooter method inherited from WebZone, and change the rendering of the footer section.

Notes to Implementers

Vous devez rarement hériter directement de la classe WebZone pour développer des zones composants WebPart personnalisées.You rarely need to inherit directly from the WebZone class to develop custom Web Parts zones. Le jeu de contrôles composants WebPart contient les zones spécialisées listées ci-dessus dans la section Notes, et vous pouvez généralement dériver de l’un d’eux pour ajouter un comportement personnalisé à une zone.The Web Parts control set contains the specialized zones listed above in the Remarks section, and usually you can derive from one of them to add custom behavior to a zone. Si vous décidez d’hériter directement de la classe WebZone, vous devez substituer un certain nombre de propriétés et de méthodes (consultez la documentation pour les membres de la classe WebZone).If you do decide to inherit directly from the WebZone class, you must override a number of properties and methods (see the documentation for the members of the WebZone class). Vous devez également créer un contrôle de WebPartManager personnalisé, éventuellement un contrôle de WebPartDisplayMode personnalisé pour créer un mode d’affichage unique dans lequel afficher votre zone, ainsi que d’autres personnalisations pour que votre zone fonctionne dans le jeu de contrôles de composants WebPart.You must also create a custom WebPartManager control, optionally a custom WebPartDisplayMode control to create a unique display mode in which to view your zone, and other customizations to make your zone work within the Web Parts control set.

Properties

AccessKey

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Inherited from WebControl)
Adapter

Obtient l'adaptateur spécifique au navigateur pour le contrôle.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
Attributes

Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Inherited from WebControl)
BackColor

Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web.Gets or sets the background color of the Web server control.

(Inherited from WebControl)
BackImageUrl

Obtient ou définit l'URL vers une image d'arrière-plan pour une zone.Gets or sets the URL to a background image for a zone.

BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.Gets the control that contains this control's data binding.

(Inherited from Control)
BorderColor

Obtient ou définit la couleur de bordure du contrôle Web.Gets or sets the border color of the Web control.

(Inherited from WebControl)
BorderStyle

Obtient ou définit le style de bordure du contrôle serveur Web.Gets or sets the border style of the Web server control.

(Inherited from WebControl)
BorderWidth

Obtient ou définit la largeur de bordure du contrôle serveur Web.Gets or sets the border width of the Web server control.

(Inherited from WebControl)
ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode

Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls

Obtient un objet ControlCollection qui représente les contrôles enfants de CompositeControl.Gets a ControlCollection object that represents the child controls in a CompositeControl.

(Inherited from CompositeControl)
ControlStyle

Obtient le style d'un contrôle serveur Web.Gets the style of the Web server control. Cette propriété est principalement utilisée par des développeurs de contrôles.This property is used primarily by control developers.

(Inherited from WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Cette propriété est principalement utilisée par des développeurs de contrôles.This property is primarily used by control developers.

(Inherited from 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.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Inherited from WebControl)
DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EmptyZoneText

Obtient ou définit un message qui s’affiche quand une zone ne contient aucun contrôle.Gets or sets a message that appears when a zone contains no controls.

EmptyZoneTextStyle

Obtient les attributs de style pour le texte d'espace réservé dans une zone vide.Gets the style attributes for the placeholder text in an empty zone.

Enabled

Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.Gets or sets a value indicating whether the Web server control is enabled.

(Inherited from WebControl)
EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle.Gets or sets a value indicating whether themes apply to this control.

(Inherited from 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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
ErrorStyle

Obtient les attributs de style pour restituer le message d'erreur qui est affiché si un contrôle WebPart ne peut pas être chargé ou créé.Gets the style attributes for rendering the error message that is displayed if a WebPart control cannot be loaded or created.

Events

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle.Gets a list of event handler delegates for the control. Cette propriété est en lecture seule.This property is read-only.

(Inherited from Control)
Font

Obtient les propriétés de police associées au contrôle serveur Web.Gets the font properties associated with the Web server control.

(Inherited from WebControl)
FooterStyle

Obtient les attributs de style pour le contenu de la zone de pied de page d'une zone.Gets the style attributes for the contents of a zone's footer area.

ForeColor

Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Inherited from WebControl)
HasAttributes

Obtient une valeur indiquant si le contrôle a des attributs définis.Gets a value indicating whether the control has attributes set.

(Inherited from 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.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
HasFooter

Obtient une valeur indiquant si une zone a une zone de pied de page.Gets a value indicating whether a zone has a footer area.

HasHeader

Obtient une valeur indiquant si une zone a une zone d'en-tête.Gets a value indicating whether a zone has a header area.

HeaderStyle

Obtient les attributs de style pour le contenu de la zone d'en-tête d'une zone.Gets the style attributes for the contents of a zone's header area.

HeaderText

Obtient ou définit le texte de la zone d’en-tête d’une zone.Gets or sets the text for the header area of a zone.

Height

Obtient ou définit la hauteur du contrôle serveur Web.Gets or sets the height of the Web server control.

(Inherited from WebControl)
ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.Gets the character used to separate control identifiers.

(Inherited from Control)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsEnabled

Obtient une valeur indiquant si le contrôle est activé.Gets a value indicating whether the control is enabled.

(Inherited from WebControl)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled

Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from 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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
Padding

Obtient ou définit les attributs de marge intérieure des cellules sur la table qui contient les contrôles WebPart dans une zone.Gets or sets the cell padding attributes on the table that contains the WebPart controls in a zone.

Page

Obtient une référence à l'instance de Page qui contient le contrôle serveur.Gets a reference to the Page instance that contains the server control.

(Inherited from 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.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
PartChromePadding

Obtient ou définit la distance entre le contenu d'un contrôle WebPart et la bordure du contrôle.Gets or sets the distance between the contents of a WebPart control and the border of the control.

PartChromeStyle

Obtient des caractéristiques de style qui s'appliquent aux bordures des contrôles WebPart contenus dans une zone.Gets style characteristics that apply to the borders of Web Parts controls contained by a zone.

PartChromeType

Obtient ou définit le type de bordure qui encadre les contrôles WebPart contenus dans une zone.Gets or sets the type of border that frames Web Parts controls contained by a zone.

PartStyle

Obtient des caractéristiques de style qui s'appliquent à la bordure et au contenu de chaque contrôle WebPart contenu dans une zone.Gets style characteristics that apply to the border and contents of each Web Parts control contained by a zone.

PartTitleStyle

Obtient des attributs de style pour le contenu de la barre de titre de chaque contrôle WebPart contenu dans une zone.Gets style attributes for the title bar content for each Web Parts control contained by a zone.

RenderClientScript

Obtient une valeur indiquant s'il faut restituer le script client sur une page WebPart.Gets a value that indicates whether to render client script on a Web Parts page.

RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID

Obtient ou définit l’apparence à appliquer au contrôle.Gets or sets the skin to apply to the control.

(Inherited from 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.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Inherited from WebControl)
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.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Inherited from CompositeControl)
TabIndex

Obtient ou définit l'index de tabulation du contrôle serveur Web.Gets or sets the tab index of the Web server control.

(Inherited from WebControl)
TagKey

Obtient la valeur HtmlTextWriterTag qui correspond à ce contrôle serveur Web.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Cette propriété est principalement utilisée par des développeurs de contrôles.This property is used primarily by control developers.

TagName

Obtient le nom de la balise du contrôle.Gets the name of the control tag. Cette propriété est principalement utilisée par des développeurs de contrôles.This property is used primarily by control developers.

(Inherited from WebControl)
TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
ToolTip

Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Inherited from WebControl)
UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from 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.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
VerbButtonType

Obtient ou définit le genre de bouton utilisé pour représenter des verbes dans une zone.Gets or sets what kind of button is used to represent verbs in a zone.

VerbStyle

Obtient les attributs de style pour les verbes d'interface utilisateur associés aux contrôles WebPart dans une zone.Gets the style attributes for the user interface (UI) verbs associated with Web Parts controls in a 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 entre plusieurs demandes de la même page.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la casse.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode

Obtient ou définit le mode d'état d'affichage de ce contrôle.Gets or sets the view-state mode of this control.

(Inherited from 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.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Inherited from Control)
WebPartManager

Obtient une référence au contrôle WebPartManager associé à une instance de contrôle WebZone sur une page WebPart.Gets a reference to the WebPartManager control associated with a WebZone control instance on a Web Parts page.

Width

Obtient ou définit la largeur du contrôle serveur web.Gets or sets the width of the Web server control.

(Inherited from WebControl)

Methods

AddAttributesToRender(HtmlTextWriter)

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

(Inherited from WebControl)
AddedControl(Control, Int32)

Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object)

Notifie au 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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from 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.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is primarily used by control developers.

(Inherited from WebControl)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de la page au contrôle.Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object)

Commence le traçage au moment du design des données de rendu.Begins design-time tracing of rendering data.

(Inherited from 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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.Deletes the control-state information for the server control's child controls.

(Inherited from 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.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState()

Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode()

Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from 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.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

(Inherited from 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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Inherited from Control)
CreateControlCollection()

Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Inherited from Control)
CreateControlStyle()

Crée l'objet de style qui est utilisé de manière interne par la classe WebControl pour implémenter toutes les propriétés associées au style.Creates the style object that is used internally by the WebControl class to implement all style related properties. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

(Inherited from WebControl)
DataBind()

Lie une source de données au CompositeControl et à tous ses contrôles enfants.Binds a data source to the CompositeControl and all its child controls.

(Inherited from 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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.Binds a data source to the server control's child controls.

(Inherited from Control)
Dispose()

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object)

Met fin au traçage au moment du design des données de rendu.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants.Determines whether the server control contains child controls. S'il ne contient pas de contrôles enfants, il en crée.If it does not, it creates child controls.

(Inherited from Control)
EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.Searches the current naming container for a server control with the specified id parameter.

(Inherited from 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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Vous ne devez pas substituer cette version de la méthode FindControl.You should not override this version of the FindControl method.

(Inherited from Control)
Focus()

Affecte le focus d'entrée à un contrôle.Sets input focus to a control.

(Inherited from Control)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.Gets design-time data for a control.

(Inherited from Control)
GetEffectiveChromeType(Part)

Retourne la valeur PartChromeType actuelle réelle ou effective d'un contrôle WebPart, étant donné la propriété PartChromeType de la zone et le mode d'affichage actuel de la page WebPart.Returns the actual or effective current PartChromeType value of a WebPart control, given the PartChromeType property of the zone and the current display mode of the Web Parts page.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents()

Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.Determines if the server control holds only literal content.

(Inherited from 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().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Inherited from Control)
LoadViewState(Object)

Charge des informations d'état enregistrées précédemment pour une zone.Loads previously saved state information for a zone.

MapPathSecure(String)

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from 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.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

(Inherited from 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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Inherited from Control)
OnDataBinding(EventArgs)

Déclenche l'événement DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnInit(EventArgs)

Déclenche l'événement Init.Raises the Init event.

OnLoad(EventArgs)

Déclenche l'événement Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs)

Déclenche l'événement PreRender.Raises the PreRender event.

OnUnload(EventArgs)

Déclenche l'événement Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String)

Obtient un Stream utilisé pour lire un fichier.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RecreateChildControls()

Recrée les contrôles enfants dans un contrôle dérivé de CompositeControl.Recreates the child controls in a control derived from CompositeControl.

(Inherited from CompositeControl)
RemovedControl(Control)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter)

Écrit le contenu de CompositeControl dans l’objet HtmlTextWriter spécifié pour un affichage sur le client.Writes the CompositeControl content to the specified HtmlTextWriter object, for display on the client.

(Inherited from CompositeControl)
RenderBeginTag(HtmlTextWriter)

Génère le rendu de la balise d'ouverture HTML du contrôle de zone via l'objet HtmlTextWriter spécifié.Renders the opening HTML tag of the zone control to the specified HtmlTextWriter object.

RenderBody(HtmlTextWriter)

Substitue le rendu pour le corps d'un contrôle de zone.Overrides rendering for the body of a zone control.

RenderChildren(HtmlTextWriter)

Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderContents(HtmlTextWriter)

Génère le rendu de tout le contenu d'un contrôle de zone entre les balises de début et de fin à l'objet via HtmlTextWriter spécifié.Renders the entire contents of a zone control between the beginning and ending tags to the specified HtmlTextWriter object.

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é.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
RenderEndTag(HtmlTextWriter)

Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié.Renders the HTML closing tag of the control into the specified writer. Cette méthode est principalement utilisée par des développeurs de contrôles.This method is used primarily by control developers.

(Inherited from WebControl)
RenderFooter(HtmlTextWriter)

Substitue le rendu pour le pied de page d'un contrôle de zone.Overrides rendering for the footer of a zone control.

RenderHeader(HtmlTextWriter)

Substitue le rendu pour l'en-tête d'un contrôle de zone.Overrides rendering for the header of a zone control.

ResolveAdapter()

Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String)

Convertit une URL en une URL que le client soit en mesure d'utiliser.Converts a URL into one that is usable on the requesting client.

(Inherited from 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.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SaveViewState()

Enregistre les changements d’état d’affichage qui se sont produits après qu’une page a été republiée sur le serveur.Saves any view-state changes that have occurred after a page was posted back to the server.

SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.Sets design-time data for a control.

(Inherited from Control)
SetRenderMethodDelegate(RenderMethod)

Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from 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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from 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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState()

Effectue le suivi des modifications apportées à l’état d’affichage d’un contrôle de zone.Tracks changes to a zone control's view state.

Events

DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.Occurs when the server control binds to a data source.

(Inherited from 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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load

Se produit lorsque le contrôle serveur est chargé dans l'objet Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender

Se produit après le chargement de l'objet Control mais avant le rendu.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.Occurs when the server control is unloaded from memory.

(Inherited from Control)

Explicit Interface Implementations

IAttributeAccessor.GetAttribute(String)

Obtient un attribut du contrôle Web avec le nom spécifié.Gets an attribute of the Web control with the specified name.

(Inherited from WebControl)
IAttributeAccessor.SetAttribute(String, String)

Affecte au nom et à la valeur spécifiés un attribut du contrôle Web.Sets an attribute of the Web control to the specified name and value.

(Inherited from WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Permet à un concepteur de recréer dans l'environnement au moment du design la collection du contrôle composite de contrôles enfants.Enables a designer to recreate the composite control's collection of child controls in the design-time environment.

(Inherited from CompositeControl)
IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.For a description of this member, see UserData.

(Inherited from Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)

Extension Methods

FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.Returns the data source that is associated with the data control for the specified control.

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é.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Obtient les métadonnées de table pour le contrôle de données spécifié.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Définit les métadonnées de table pour le contrôle de données spécifié.Sets the table metadata for the specified data control.

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é.Sets the table metadata and default value mapping for the specified data control.

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é.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Détermine si des métadonnées de table sont disponibles.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Active le comportement Dynamic Data pour le contrôle de données spécifié.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Active le comportement Dynamic Data pour le contrôle de données spécifié.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Active le comportement Dynamic Data pour le contrôle de données spécifié.Enables Dynamic Data behavior for the specified data control.

Applies to

See also