WebPart.Hidden Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

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à

Boolean

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

Attributi
ThemeableAttribute PersonalizableAttribute

Esempio

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

Si noti che nella pagina Web, nel markup dichiarativo per l'elemento, il Hidden valore dell'attributo <aspSample:TextDisplayWebPart> è 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 può 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 sua zona, viene effettivamente eseguito il rendering nella 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é i controlli chiusi non vengono nemmeno visualizzati in una pagina, mentre i controlli nascosti vengono visualizzati e attivi nelle applicazioni Web part, anche se non sono visibili agli utenti. Il set di controlli Web part nasconde il controllo impostando lo WebPart stile css (cascading) su un valore di display:none.

Anche se la Hidden proprietà per un controllo è impostata su true, il controllo viene ancora visualizzato se la modalità di visualizzazione corrente nella pagina consente la visualizzazione dei controlli nascosti. Ad esempio, la modalità di modifica consente la visualizzazione di 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 proprietà di un WebPart controllo è impostata su false, ovvero l'impostazione Hidden predefinita, il controllo viene visualizzato nella pagina. Si noti che se la AllowHide proprietà è impostata su false, gli utenti finali non possono 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 skin.

Si applica a

Vedi anche