Freigeben über

WebPart.Hidden Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein WebPart Steuerelement auf einer Webseite angezeigt wird.

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

Boolean

false wenn das WebPart Steuerelement auf einer Webseite angezeigt wird; andernfalls true. Der Standardwert ist false.

Attribute
ThemeableAttribute PersonalizableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Hidden Eigenschaft für ein benutzerdefiniertes Webpart-Steuerelement veranschaulicht. In diesem Beispiel wird davon ausgegangen, dass ein benutzerdefiniertes Steuerelement verwendet wird, TextDisplayWebPartdas sich im Beispielabschnitt der WebPart Klassenübersicht befindet.

Beachten Sie, dass auf der Webseite im deklarativen Markup für das <aspSample:TextDisplayWebPart> Element der Hidden Attributwert festgelegt trueist. Das TextDisplayWebPart Steuerelement wird nicht angezeigt, wenn die Seite in einem Browser geladen wird. Das Steuerelement ist jedoch weiterhin auf der Seite und in seiner Zone vorhanden, und es 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 ausgeblendetes WebPart 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 sind, da geschlossene Steuerelemente nicht einmal auf einer Seite gerendert werden, während ausgeblendete Steuerelemente in Webpartanwendungen gerendert und aktiv sind, obwohl sie für Benutzer nicht sichtbar sind. Das Steuerelement "Webparts" blendet das WebPart Steuerelement aus, indem das Css-Format (Cascading Stylesheet) auf einen Wert festgelegt display:nonewird.

Selbst wenn die Hidden Eigenschaft für ein Steuerelement festgelegt trueist, wird das Steuerelement weiterhin angezeigt, wenn der aktuelle Anzeigemodus auf der Seite die Anzeige ausgeblendeter Steuerelemente zulässt. Im Bearbeitungsmodus können z. B. ausgeblendete Steuerelemente angezeigt werden, sodass 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 für ein WebPart Steuerelement auf false", die Standardeinstellung ist, wird das Steuerelement auf der Seite angezeigt. Beachten Sie, dass Endbenutzer, wenn die AllowHide Eigenschaft auf false"Festgelegt" festgelegt ist, den Hidden Eigenschaftswert nicht bearbeiten dürfen.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Designs und Skins.

Gilt für:

Weitere Informationen