Lire en anglais

Partager via


PartChromeType Énumération

Définition

Spécifie le type de bordure qui entoure un contrôle WebPart.

C#
public enum PartChromeType
Héritage
PartChromeType

Champs

BorderOnly 4

Bordure uniquement, sans barre de titre.

Default 0

Paramètre de bordure hérité de la zone contenante du contrôle Part.

None 2

Aucune bordure et aucune barre de titre.

TitleAndBorder 1

Barre de titre et bordure.

TitleOnly 3

Barre de titre uniquement, sans bordure.

Exemples

Les exemples de code suivants illustrent l’utilisation déclarative de l’énumération à l’aide PartChromeType d’un contrôle personnalisé WebPart référencé dans une page Web ASP.NET. 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é.

La première partie de l’exemple contient le code du contrôle personnalisé, nommé TextDisplayWebPart. Étant donné que le contrôle dérive de WebPart, il hérite également des propriétés communes que la Part classe fournit, y compris la ChromeType propriété , qui utilise l’énumération PartChromeType comme type de retour.

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

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

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

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

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

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

Notez que dans le balisage déclaratif de la page Web, la deuxième instance du TextDisplayWebPart contrôle définit sa ChromeType valeur de propriété sur TitleOnly. Une fois que vous avez chargé la page dans un navigateur, la deuxième instance de contrôle apparaît réduite. Lorsque vous développez le deuxième contrôle, il n’a qu’une barre de titre sans bordure.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Remarques

L’énumération d’un contrôle de PartChromeType composant détermine le type de bordure qui entoure un contrôle WebPart. Les options incluent l’affichage d’une barre de titre uniquement, d’une bordure uniquement, d’une barre de titre et d’une bordure, ou aucune des deux.

Si la valeur d’énumération est définie sur Default sur la ChromeType propriété d’un contrôle de composant, le contrôle hérite de son paramètre de la PartChromeType propriété de la zone qui contient le contrôle.

S’applique à

Voir aussi