WebPart.Hidden Eigenschaft

Referenz

Definition

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

Assembly:: System.Web.dll

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

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 sich im Abschnitt Beispiel der WebPart Klassenübersicht befindet.

Beachten Sie, dass auf der Webseite im deklarativen Markup für das <aspSample:TextDisplayWebPart> Element der Hidden Attributwert auf truefestgelegt ist. 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 WebPart Steuerelement, das ausgeblendet ist, verbleibt in seiner Zone, wird tatsächlich auf seiner Seite gerendert und nimmt an Seitenlebenszyklusphasen wie der PreRender -Phase teil, obwohl 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 Webpartsanwendungen gerendert und aktiv werden, wenn auch nicht für Benutzer sichtbar. Der Webparts-Steuerelementsatz blendet das WebPart Steuerelement aus, indem das CSS-Format (Cascading Stylesheet) auf den Wert festgelegt wird display:none.

Auch wenn die Hidden -Eigenschaft für ein Steuerelement auf truefestgelegt ist, wird das Steuerelement weiterhin angezeigt, wenn im aktuellen Anzeigemodus auf der Seite ausgeblendete Steuerelemente angezeigt werden können. Im Bearbeitungsmodus können beispielsweise 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 eines WebPart Steuerelements auf falsefestgelegt ist, was die Standardeinstellung ist, wird das Steuerelement auf der Seite angezeigt. Beachten Sie, dass Endbenutzer den AllowHide Eigenschaftswert nicht bearbeiten dürfen, wenn die Hidden Eigenschaft auf falsefestgelegt ist.

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:

Freigeben über