Lire en anglais

Partager via

WebPart.Subtitle Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

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

[System.ComponentModel.Browsable(false)]
public virtual string Subtitle { get; }

Valeur de propriété

String

Chaîne qui s'utilise en tant que sous-titre pour le contrôle. La valeur par défaut est une chaîne vide ("").

Implémente

Subtitle
Attributs
BrowsableAttribute

Exemples

L’exemple de code suivant montre comment fournir un sous-titre pour les instances d’un contrôle personnalisé WebPart .

La première partie de cet exemple contient le code d’un contrôle personnalisé nommé TextDisplayWebPart. Ce contrôle est identique au contrôle personnalisé qui se trouve dans la section Exemple de la vue d’ensemble de la WebPart classe, sauf qu’il remplace également la Subtitle propriété pour fournir un sous-titre standard contenant un nom d’entreprise fictif pour les instances du contrôle personnalisé. Pour que l’exemple de code s’exécute, vous devez compiler ce code source. Vous pouvez le compiler explicitement et placer l’assembly résultant dans le dossier Bin de votre site web ou dans le global assembly cache. Vous pouvez également placer le code source dans le dossier App_Code de votre site, où il sera compilé dynamiquement au moment de l’exécution. Cet exemple de code part du principe que vous compilez le code source dans un assembly, que vous le placez dans un sous-dossier Bin de votre application web et que vous référencez l’assembly avec une Register directive dans votre page web. Pour obtenir une procédure pas à pas qui illustre les deux méthodes de compilation, consultez Procédure pas à pas : développement et utilisation d’un contrôle de serveur web personnalisé.

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

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

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

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

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

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

La deuxième partie de l’exemple est une page Web qui montre comment référencer le TextDisplayWebPart contrôle dans une page Web ASP.NET. Après avoir chargé la page dans un navigateur, le texte de la barre de titre du contrôle inclut le titre attribué au contrôle dans le balisage déclaratif, un séparateur de trait d’union et la valeur du sous-titre personnalisé du TextDisplayWebPart contrôle.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text WebPart" 
            />
          </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Remarques

Utilisez éventuellement la Subtitle propriété pour renvoyer une chaîne de sous-titre standard dans votre contrôle personnalisé WebPart qui sera ajoutée au titre du contrôle.

Si vous fournissez une valeur pour la Subtitle propriété dans un contrôle personnalisé WebPart , le jeu de contrôles WebPart l’ajoute automatiquement à la valeur de la Title propriété pour créer un titre complet pour le contrôle.

La valeur de cette propriété, lorsqu’elle est définie, peut être enregistrée automatiquement dans un fichier de ressources à l’aide d’un outil de concepteur. Pour plus d’informations, consultez LocalizableAttributeglobalisation et localisation.

Notes pour les héritiers

Pour fournir un sous-titre pour les instances d’un contrôle personnalisé WebPart , vous devez remplacer la Subtitle propriété .

S’applique à

Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Voir aussi