WebPart.Hidden Egenskap

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Hämtar eller anger ett värde som anger om en WebPart kontroll visas på en webbsida.

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

Egenskapsvärde

Boolean

falseom kontrollen WebPart visas på en webbsida, annars . true Standardvärdet är false.

Attribut
ThemeableAttribute PersonalizableAttribute

Exempel

I följande kodexempel visas hur egenskapen används Hidden för en anpassad webbdelskontroll. I det här exemplet förutsätts användningen av en anpassad kontroll, TextDisplayWebPart, som finns i avsnittet Exempel i klassöversikten WebPart .

Observera att i elementets deklarativa markering <aspSample:TextDisplayWebPart> på webbsidan Hidden är attributvärdet inställt på true. Kontrollen TextDisplayWebPart visas inte om sidan läses in i en webbläsare. Kontrollen finns dock fortfarande på sidan och i dess zon, och den kan fortfarande delta i anslutningar med andra WebPart kontroller om du har skapat anslutningarna.

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

Kommentarer

En WebPart kontroll som är dold finns kvar i zonen, återges faktiskt på sidan och deltar i sidlivscykelfaser som fasen, även om den PreRender inte visas i en webbläsare. Detta skiljer sig från WebPart kontroller som är stängda eftersom stängda kontroller inte ens återges på en sida, medan dolda kontroller återges och är aktiva i webbdelsprogram, men inte synliga för användarna. Kontrolluppsättningen Webbdelar döljer kontrollen genom att ange css-formatmallen WebPart (cascading style sheet) till värdet display:none.

Även om Hidden egenskapen för en kontroll är inställd truepå visas kontrollen fortfarande om det aktuella visningsläget på sidan tillåter att dolda kontroller visas. Redigeringsläget gör till exempel att dolda kontroller kan visas så att användarna kan redigera dem. När dolda kontroller visas i vissa visningslägen visar kontrollens rubrik en sträng som anger att kontrollen är i dold status.

När egenskapen Hidden på en WebPart kontroll är inställd falsepå , vilket är standard, visas kontrollen på sidan. Observera att om egenskapen AllowHide är inställd på falsefår slutanvändarna inte redigera egenskapsvärdet Hidden .

Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.

Gäller för

Se även