WebPart.Hidden Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.