Cette documentation est archivée et n’est pas conservée.

Panel, classe

Mise à jour : novembre 2007

Représente un contrôle servant de conteneur pour d'autres contrôles.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class Panel : WebControl
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class Panel extends WebControl
public class Panel extends WebControl
<asp:Panel />

Le contrôle Panel est un conteneur pour d'autres contrôles. Il s'avère particulièrement utile lorsque vous souhaitez générer des contrôles par programme, masquer/afficher un groupe de contrôles ou localiser un groupe de contrôles.

La propriété Direction permet de localiser le contenu d'un contrôle Panel afin d'afficher du texte pour les langues qui s'écrivent de droite à gauche, comme l'arabe ou l'hébreu.

Le contrôle Panel fournit des plusieurs propriétés qui vous permettent de personnaliser le comportement et l'affichage de son contenu. Utilisez la propriété BackImageUrl pour afficher une image personnalisée destinée au contrôle Panel. Utilisez la propriété ScrollBars pour spécifier les barres de défilement du contrôle.

TopicLocation
Comment : ajouter des contrôles serveur Web Panel à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une application Web accessibleGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : création d'une application Web accessibleGénération d'applications à l'aide de Visual Web Developer
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web Panel à une page Web FormsGénération d'applications Web ASP.NET
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles Panel à une page Web FormsGénération d'applications Web ASP.NET dans Visual Studio
Comment : localiser les contrôles Web Forms sur une page en parcourant la collection ControlsGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles Panel à une page Web FormsGénération d'applications Web ASP.NET dans Visual Studio
Comment : localiser les contrôles Web Forms sur une page en parcourant la collection ControlsGénération d'applications Web ASP.NET dans Visual Studio
Comment : localiser les contrôles Web Forms sur une page en parcourant la collection ControlsGénération d'applications Web ASP.NET

L'exemple suivant illustre la génération par programme de contrôles et le masquage/l'affichage d'un groupe de contrôles à l'aide d'un contrôle Panel.

Remarque :

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code Web Forms, consultez Modèle de code des pages Web ASP.NET.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>Panel Example</title>
<script runat="server">

       void Page_Load(Object sender, EventArgs e) {

          // Show or hide the Panel contents.

          if (Check1.Checked) {
             Panel1.Visible=false;
          }
          else {
             Panel1.Visible=true;
          }

          // Generate the Label controls.

          int numlabels = Int32.Parse(DropDown1.SelectedItem.Value);

          for (int i=1; i<=numlabels; i++) {
             Label l = new Label();
             l.Text = "Label" + (i).ToString();
             l.ID = "Label" + (i).ToString();
             Panel1.Controls.Add(l);
             Panel1.Controls.Add(new LiteralControl("<br />"));
          }

          // Generate the Textbox controls.

          int numtexts = Int32.Parse(DropDown2.SelectedItem.Value);

          for (int i=1; i<=numtexts; i++) {
             TextBox t = new TextBox();
             t.Text = "TextBox" + (i).ToString();
             t.ID = "TextBox" + (i).ToString();
             Panel1.Controls.Add(t);
             Panel1.Controls.Add(new LiteralControl("<br />"));
          }
       }

    </script>

 </head>
 <body>

    <h3>Panel Example</h3>

    <form id="form1" runat="server">

       <asp:Panel id="Panel1" runat="server"
            BackColor="gainsboro"
            Height="200px"
            Width="300px">

            Panel1: Here is some static content...
            <br />

       </asp:Panel>

       <br />

       Generate Labels:
       <asp:DropDownList id="DropDown1" runat="server">
          <asp:ListItem Value="0">0</asp:ListItem>
          <asp:ListItem Value="1">1</asp:ListItem>
          <asp:ListItem Value="2">2</asp:ListItem>
          <asp:ListItem Value="3">3</asp:ListItem>
          <asp:ListItem Value="4">4</asp:ListItem>
       </asp:DropDownList>

       <br />

       Generate TextBoxes:
       <asp:DropDownList id="DropDown2" runat="server">
          <asp:ListItem Value="0">0</asp:ListItem>
          <asp:ListItem Value="1">1</asp:ListItem>
          <asp:ListItem Value="2">2</asp:ListItem>
          <asp:ListItem Value="3">3</asp:ListItem>
          <asp:ListItem Value="4">4</asp:ListItem>
       </asp:DropDownList>

       <br />
       <asp:CheckBox id="Check1" Text="Hide Panel" runat="server"/>

       <br />
       <asp:Button Text="Refresh Panel" runat="server"/>


    </form>

 </body>
 </html>



Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: