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

示例

下面的代码示例演示了对自定义Web 部件控件的属性的使用Hidden。 此示例假定使用自定义控件， 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控件。

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

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

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

适用于

另请参阅