WebPart.Hidden Propriété

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 WebPart personnalisé. Cet exemple suppose l’utilisation d’un contrôle personnalisé, TextDisplayWebPart, qui 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 valeur de l’attribut Hidden 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 à des 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 s’il n’est pas visible dans un navigateur. Cela diffère des WebPart contrôles qui sont fermés, car les contrôles fermés ne sont même pas affichés sur une page, tandis que les contrôles masqués sont rendus et actifs dans les applications WebPart, bien que non visibles par les utilisateurs. Le jeu de contrôles 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 sur true, le contrôle est toujours affiché si le mode d’affichage actuel sur la page autorise l’affichage des contrôles masqués. Par exemple, le mode édition permet d’afficher des contrôles masqués, afin que les utilisateurs puissent les modifier. Lorsque des 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 , ce 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 valeur de la Hidden 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 apparences.

S’applique à

Partager via