WebPart.Hidden Propriété

  • Référence

Définition

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

Obtient ou définit une valeur qui indique si un contrôle WebPart s'affiche sur une page Web.

public:
 virtual property bool Hidden { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
[System.Web.UI.WebControls.WebParts.Personalizable]
public virtual bool Hidden { get; set; }
[<System.Web.UI.Themeable(false)>]
[<System.Web.UI.WebControls.WebParts.Personalizable>]
member this.Hidden : bool with get, set
Public Overridable Property Hidden As Boolean

Valeur de propriété

Boolean

false si le contrôle WebPart s'affiche sur une page Web ; sinon, true. La valeur par défaut est false.

Attributs
ThemeableAttribute PersonalizableAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la Hidden propriété pour un contrôle de composants WebPart personnalisé. Cet exemple suppose l’utilisation d’un contrôle personnalisé, TextDisplayWebPartqui se trouve dans la section Exemple de la vue d’ensemble de la WebPart classe.

Notez que dans la page Web, dans le balisage déclaratif de l’élément <aspSample:TextDisplayWebPart> , la Hidden valeur d’attribut est définie sur true. Le TextDisplayWebPart contrôle n’apparaît pas si la page est chargée dans un navigateur. Toutefois, le contrôle est toujours présent sur la page et dans sa zone, et il peut toujours participer aux connexions avec d’autres WebPart contrôles si vous avez créé ces connexions.

<%@ 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 Content WebPart" 
            Hidden="true" />
          </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>

<!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 Content WebPart" 
            Hidden="true" />
          </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Remarques

Un WebPart contrôle qui est masqué reste dans sa zone, est réellement rendu sur sa page et participe à des phases de cycle de vie de page telles que la PreRender phase, même si elle n’est pas visible dans un navigateur. Ceci est différent des WebPart contrôles fermés, car les contrôles fermés ne sont même pas rendus sur une page, tandis que les contrôles masqués sont rendus et actifs dans composants WebPart applications, mais pas visibles par les utilisateurs. Le jeu de contrôles composants WebPart masque le WebPart contrôle en définissant son style de feuille de style en cascade (CSS) sur une valeur de display:none.

Même si la Hidden propriété d’un contrôle est définie truesur , le contrôle est toujours affiché si le mode d’affichage actuel de la page permet aux contrôles masqués d’être affichés. Par exemple, le mode d’édition permet aux contrôles masqués d’être affichés afin que les utilisateurs puissent les modifier. Lorsque les contrôles masqués sont visibles dans certains modes d’affichage, le titre du contrôle affiche une chaîne indiquant que le contrôle est dans l’état masqué.

Lorsque la Hidden propriété d’un WebPart contrôle est définie falsesur , qui est la valeur par défaut, le contrôle s’affiche sur la page. Notez que si la AllowHide propriété est définie sur false, les utilisateurs finaux ne sont pas autorisés à modifier la Hidden valeur de la propriété.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET thèmes et peaux.

S’applique à

Voir aussi