WebPart.Hidden Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob ein WebPart-Steuerelement auf einer Webseite angezeigt wird, oder legt diesen fest.
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
Eigenschaftswert
false
, wenn das WebPart-Steuerelement auf einer Webseite angezeigt wird, andernfalls true
. Der Standardwert ist false
.
- Attribute
Beispiele
Im folgenden Codebeispiel wird die Verwendung der Hidden Eigenschaft für ein benutzerdefiniertes Webparts-Steuerelement veranschaulicht. In diesem Beispiel wird davon ausgegangen, dass ein benutzerdefiniertes Steuerelement verwendet wird, TextDisplayWebPart
das im Beispielabschnitt der WebPart Klassenübersicht gefunden wird.
Beachten Sie, dass auf der Webseite im deklarativen Markup für das <aspSample:TextDisplayWebPart>
Element der Hidden
Attributwert festgelegt true
ist. Das TextDisplayWebPart
Steuerelement wird nicht angezeigt, wenn die Seite in einem Browser geladen wird. Das Steuerelement ist jedoch immer noch auf der Seite und in seiner Zone vorhanden und kann weiterhin an Verbindungen mit anderen WebPart Steuerelementen teilnehmen, wenn Sie diese Verbindungen erstellt haben.
<%@ 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>
Hinweise
Ein WebPart ausgeblendetes Steuerelement verbleibt in seiner Zone, wird tatsächlich auf seiner Seite gerendert und nimmt an Seitenlebenszyklusphasen wie der PreRender
Phase teil, auch wenn es in einem Browser nicht sichtbar ist. Dies unterscheidet sich von WebPart Steuerelementen, die geschlossen werden, da geschlossene Steuerelemente nicht einmal auf einer Seite gerendert werden, während ausgeblendete Steuerelemente in Webparts Anwendungen gerendert und aktiv werden, obwohl für Benutzer nicht sichtbar sind. Das steuerelement Webparts-Steuerelement blendet das WebPart Steuerelement aus, indem die Cascading Stylesheet-Formatvorlage (CSS) auf einen Wert display:none
festgelegt wird.
Auch wenn die Hidden Eigenschaft für ein Steuerelement auf true
festgelegt ist, wird das Steuerelement weiterhin angezeigt, wenn der aktuelle Anzeigemodus auf der Seite ausgeblendete Steuerelemente angezeigt werden kann. So kann der Bearbeitungsmodus beispielsweise ausgeblendete Steuerelemente angezeigt werden, damit Benutzer sie bearbeiten können. Wenn ausgeblendete Steuerelemente in bestimmten Anzeigemodi sichtbar sind, zeigt der Titel des Steuerelements eine Zeichenfolge an, die angibt, dass sich das Steuerelement im ausgeblendeten Status befindet.
Wenn die Hidden Eigenschaft auf einem WebPart Steuerelement auf false
festgelegt ist , was die Standardeinstellung ist, wird das Steuerelement auf der Seite angezeigt. Beachten Sie, dass die Eigenschaft, wenn die AllowHide Eigenschaft auf false
festgelegt ist, Endbenutzer nicht den Eigenschaftswert bearbeiten Hidden dürfen.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.