共用方式為

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 屬性用法。 此範例假設使用自定義控件 ， TextDisplayWebPart其位於類別概觀的 WebPart Example 區段中。

請注意，在網頁中，在專案的宣告式標記 <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 主題和外觀。

適用於

另請參閱