WebPart.Hidden Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een WebPart besturingselement wordt weergegeven op een webpagina.

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

Waarde van eigenschap

Boolean

falseals het WebPart besturingselement wordt weergegeven op een webpagina; anders. true De standaardwaarde is false.

Kenmerken
ThemeableAttribute PersonalizableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de Hidden eigenschap voor een aangepast besturingselement voor webonderdelen. In dit voorbeeld wordt ervan uitgegaan dat een aangepast besturingselement wordt gebruikt. TextDisplayWebPartDit vindt u in de sectie Voorbeeld van het WebPart klassenoverzicht.

U ziet dat op de webpagina, in de declaratieve markeringen voor het <aspSample:TextDisplayWebPart> element, de Hidden kenmerkwaarde is ingesteld op true. Het TextDisplayWebPart besturingselement wordt niet weergegeven als de pagina in een browser wordt geladen. Het besturingselement bevindt zich echter nog steeds op de pagina en in de zone en kan nog steeds deelnemen aan verbindingen met andere WebPart besturingselementen als u deze verbindingen hebt gemaakt.

<%@ 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>

Opmerkingen

Een WebPart besturingselement dat verborgen is, blijft in de zone staan, wordt daadwerkelijk weergegeven op de pagina en neemt deel aan fasen van de levenscyclus van de pagina, zoals de PreRender fase, ook al is het niet zichtbaar in een browser. Dit verschilt van WebPart besturingselementen die zijn gesloten, omdat gesloten besturingselementen niet eens op een pagina worden weergegeven, terwijl verborgen besturingselementen worden weergegeven en actief zijn in webonderdelentoepassingen, maar niet zichtbaar voor gebruikers. De besturingsset webonderdelen verbergt het WebPart besturingselement door de css-stijl (trapsgewijze opmaakmodel) in te stellen op een waarde van display:none.

Zelfs als de Hidden eigenschap voor een besturingselement is ingesteld op true, wordt het besturingselement nog steeds weergegeven als de huidige weergavemodus op de pagina toestaat dat verborgen besturingselementen worden weergegeven. Met de bewerkingsmodus kunnen verborgen besturingselementen bijvoorbeeld worden weergegeven, zodat gebruikers ze kunnen bewerken. Wanneer verborgen besturingselementen zichtbaar zijn in bepaalde weergavemodi, wordt in de titel van het besturingselement een tekenreeks weergegeven die aangeeft dat het besturingselement de verborgen status heeft.

Wanneer de Hidden eigenschap van een WebPart besturingselement is ingesteld op false, wat de standaardinstelling is, wordt het besturingselement weergegeven op de pagina. Houd er rekening mee dat als de AllowHide eigenschap is ingesteld op false, eindgebruikers de Hidden eigenschapswaarde niet mogen bewerken.

Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.

Van toepassing op

Zie ook