WebPart.Hidden Eigenschaft

  • Referenz

Definition

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

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

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 Webparts-Steuerelement veranschaulicht. In diesem Beispiel wird davon ausgegangen, dass ein benutzerdefiniertes Steuerelement verwendet wird, TextDisplayWebPartdas 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 trueist. 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:nonefestgelegt wird.

Auch wenn die Hidden Eigenschaft für ein Steuerelement auf truefestgelegt 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 falsefestgelegt ist , was die Standardeinstellung ist, wird das Steuerelement auf der Seite angezeigt. Beachten Sie, dass die Eigenschaft, wenn die AllowHide Eigenschaft auf falsefestgelegt 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.

Gilt für

Siehe auch