Sdílet prostřednictvím

WebPart.Hidden Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Získá nebo nastaví hodnotu určující, zda WebPart je ovládací prvek zobrazen na webové stránce.

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

Hodnota vlastnosti

Boolean

false WebPart pokud je ovládací prvek zobrazen na webové stránce; jinak , true. Výchozí hodnota je false.

Atributy
ThemeableAttribute PersonalizableAttribute

Příklady

Následující příklad kódu ukazuje použití Hidden vlastnosti pro vlastní ovládací prvek webové části. Tento příklad předpokládá použití vlastního ovládacího prvku , TextDisplayWebPartkterý se nachází v části Příklad přehledu WebPart třídy.

Všimněte si, že na webové stránce je v deklarativním kódu prvku <aspSample:TextDisplayWebPart> nastavena truehodnota atributu Hidden . Ovládací TextDisplayWebPart prvek se nezobrazí, pokud je stránka načtena v prohlížeči. Ovládací prvek se ale stále nachází na stránce a v jeho zóně a přesto se může účastnit připojení k jiným WebPart ovládacím prvkům, pokud jste tato připojení vytvořili.

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

Poznámky

Ovládací WebPart prvek, který je skrytý, zůstává v jeho zóně, je ve skutečnosti vykreslen na své stránce a účastní se fází životního cyklu stránky, jako PreRender je fáze, i když není viditelný v prohlížeči. To se liší od WebPart ovládacích prvků, které jsou zavřené, protože zavřené ovládací prvky nejsou ani vykresleny na stránce, zatímco skryté ovládací prvky jsou vykresleny a aktivní v aplikacích webových částí, i když nejsou viditelné pro uživatele. Sada ovládacích částí webových částí skryje WebPart ovládací prvek nastavením stylu šablony stylů CSS na hodnotu display:none.

I když Hidden je vlastnost ovládacího prvku nastavena na true, ovládací prvek se stále zobrazí, pokud aktuální režim zobrazení na stránce umožňuje zobrazení skrytých ovládacích prvků. Režim úprav například umožňuje zobrazení skrytých ovládacích prvků, aby je uživatelé mohli upravovat. Pokud jsou skryté ovládací prvky viditelné v určitých režimech zobrazení, zobrazí název ovládacího prvku řetězec označující, že ovládací prvek je ve skrytém stavu.

Hidden Pokud je vlastnost WebPart ovládacího prvku nastavena na false, což je výchozí, ovládací prvek se zobrazí na stránce. Všimněte si, že pokud AllowHide je vlastnost nastavena na false, koncoví uživatelé nemají povoleno upravovat Hidden hodnotu vlastnosti.

Tuto vlastnost nelze nastavit motivy ani motivy šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.

Platí pro

Viz také