Partage via

WebPart.Hidden Propriété

Définition

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

Obtient ou définit une valeur indiquant si un WebPart contrôle est affiché 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 WebPart contrôle est affiché 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 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 truesur . 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 masqué reste dans sa zone, est en fait affiché 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. Cela diffère 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 les applications de composants WebPart, bien qu’ils ne soient pas visibles par les utilisateurs. Le jeu de contrôles WebPart masque le WebPart contrôle en définissant son style en cascade (CSS) sur une valeur .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 falsesur , les utilisateurs finaux ne sont pas autorisés à modifier la valeur de propriété Hidden .

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

S’applique à

Voir aussi