通过

WebPart.Hidden 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

获取或设置一个值，该值指示是否在网页上显示 WebPart 控件。

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

属性值

Boolean

如果在网页上显示 WebPart 控件，则为 false；否则为 true。 默认值是 false。

属性
ThemeableAttribute PersonalizableAttribute

示例

下面的代码示例演示如何 Hidden 将 属性用于自定义 Web 部件控件。 此示例假定使用自定义控件 ， TextDisplayWebPart该控件位于类概述的 WebPart “示例”部分。

请注意，在网页中，在 元素的 <aspSample:TextDisplayWebPart> 声明性标记中 Hidden ，属性值设置为 true。 TextDisplayWebPart如果在浏览器中加载页面，则不会显示控件。 但是，控件仍存在于页面及其区域中，如果你创建了这些连接，它仍然可以参与与其他 WebPart 控件的连接。

<%@ 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>

注解

WebPart隐藏的控件将保留在其区域中，实际呈现在其页面上，并参与页面生命周期阶段（如PreRender阶段），即使它在浏览器中不可见。 这与 WebPart 关闭的控件不同，因为关闭的控件甚至不会在页面上呈现，而隐藏的控件在 Web 部件应用程序中呈现并处于活动状态，但用户不可见。 Web 部件控件集通过将其级联样式表 (CSS) 样式设置为 值display:none来隐藏WebPart控件。

即使 Hidden 控件的 属性设置为 true，如果页面上的当前显示模式允许显示隐藏控件，则控件仍会显示。 例如，编辑模式允许显示隐藏控件，以便用户可以编辑它们。 当隐藏控件在某些显示模式下可见时，控件的标题将显示一个字符串，指示控件处于隐藏状态。

Hidden当控件上的 WebPart 属性设置为 false（默认值）时，控件将显示在页面上。 请注意，如果 属性 AllowHide 设置为 false，则不允许最终用户编辑 Hidden 属性值。

无法通过主题或样式表主题设置此属性。 有关详细信息，请参阅 ThemeableAttribute 和 ASP.NET 主题和外观。

适用于

另请参阅