WebPart.Hidden 屬性

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

屬性值

false若控制WebPart項顯示於網頁;否則，。 true 預設值為 false。

屬性

ThemeableAttribute PersonalizableAttribute

範例

以下程式碼範例展示了該 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 Parts 應用程式中被渲染並啟用，但使用者無法看到。 Web Parts 控制集透過將其層疊樣式表（CSS）樣式設定為 WebPart，隱藏控制display:none項。

即使 Hidden 控制項屬性設為 true，只要頁面上的顯示模式允許隱藏控制項顯示，該控制項仍會被顯示。 例如，編輯模式允許顯示隱藏控制項，讓使用者可以自行編輯。 當某些顯示模式下顯示隱藏控制鍵時，控制鍵標題會顯示一個字串，表示該控制鍵處於隱藏狀態。

當 Hidden 控制項上的 WebPart 屬性設定為 false預設值時，控制項會顯示在頁面上。 請注意，如果 AllowHide 屬性設定為 false，終端使用者無法編輯 Hidden 屬性值。

此屬性無法由主題或樣式表主題設定。 更多資訊請參閱 ThemeableAttribute 並 ASP.NET 主題與皮膚。

另請參閱

• AllowHide
• ASP.NET 網頁零件控制