通过

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

false WebPart如果控件显示在网页上，则为 ;否则为 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 主题和外观。

适用于

另请参阅