WebPart.Hidden Proprietà

Definizione

Ottiene o imposta un valore che indica se un controllo WebPart viene visualizzato in una pagina 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

Valore della proprietà

false se il controllo WebPart è visualizzato in una pagina Web. In caso contrario, true. Il valore predefinito è false.

Attributi

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della Hidden proprietà per un controllo Web part personalizzato. In questo esempio si presuppone l'uso di un controllo personalizzato, TextDisplayWebPart, disponibile nella sezione Esempio della panoramica della WebPart classe.

Si noti che nella pagina Web, nel markup dichiarativo per l'elemento, il valore dell'attributo <aspSample:TextDisplayWebPart>Hidden è impostato su true. Il TextDisplayWebPart controllo non verrà visualizzato se la pagina viene caricata in un browser. Tuttavia, il controllo è ancora presente nella pagina e nella relativa zona e potrebbe comunque partecipare alle connessioni con altri WebPart controlli se sono state create tali connessioni.

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

Commenti

Un WebPart controllo nascosto rimane nella relativa zona, viene effettivamente eseguito il rendering nella relativa pagina e partecipa alle fasi del ciclo di vita della pagina, ad esempio la PreRender fase, anche se non è visibile in un browser. Ciò è diverso dai WebPart controlli chiusi, perché il rendering dei controlli chiusi non viene eseguito nemmeno in una pagina, mentre il rendering dei controlli nascosti viene eseguito e attivo nelle applicazioni Web part, anche se non è visibile agli utenti. Il set di controlli Web part nasconde il controllo impostando lo WebPart stile CSS (Cascading Style Sheet) su un valore di display:none.

Anche se la Hidden proprietà di un controllo è impostata su true, il controllo viene comunque visualizzato se la modalità di visualizzazione corrente nella pagina consente la visualizzazione dei controlli nascosti. Ad esempio, la modalità di modifica consente di visualizzare i controlli nascosti, in modo che gli utenti possano modificarli. Quando i controlli nascosti sono visibili in determinate modalità di visualizzazione, il titolo del controllo visualizza una stringa che indica che il controllo è in stato nascosto.

Quando la Hidden proprietà di un WebPart controllo è impostata su false, ovvero l'impostazione predefinita, il controllo viene visualizzato nella pagina. Si noti che se la AllowHide proprietà è impostata su false, gli utenti finali non sono autorizzati a modificare il valore della Hidden proprietà.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Si applica a

Vedi anche