WebPart.Hidden 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

取得或設定值，指出 WebPart 控制項是否顯示在 Web 網頁上。

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 控制項可以顯示在 Web 網頁上，則為 false，否則為 true。 預設值是 false。

屬性
ThemeableAttribute PersonalizableAttribute

範例

下列程式碼範例示範自訂Web 組件控制項的 屬性用法 Hidden 。 本範例假設使用類別概觀的範例區段中 WebPart 所找到的自訂控制項 TextDisplayWebPart 。

請注意，在網頁中，在 專案的宣告式標記 <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 組件控制項集會將控制項的級聯樣式表單設定為 的值 display:none ， (CSS) 樣式來隱藏 WebPart 控制項。

即使 Hidden 控制項的 屬性設定 true 為 ，如果頁面上目前的顯示模式允許顯示隱藏的控制項，仍會顯示控制項。 例如，編輯模式允許顯示隱藏的控制項，讓使用者可以編輯這些控制項。 當隱藏控制項在特定顯示模式中顯示時，控制項的標題會顯示字串，指出控制項處於隱藏狀態。

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

這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊，請參閱 ThemeableAttribute 和ASP.NET 主題和麵板。

適用於

另請參閱