次の方法で共有

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

コントロールが Web ページに表示される場合は a0/&。それ以外の場合は。 既定値は false です。

属性
ThemeableAttribute PersonalizableAttribute

例

次のコード例では、カスタム Web パーツ コントロールに Hidden プロパティを使用する方法を示します。 この例では、WebPart クラスの概要の「例」セクションにあるカスタム コントロール (TextDisplayWebPart) を使用することを前提としています。

Web ページでは、 <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 フェーズなどのページ ライフ サイクル フェーズに参加します。 これは、閉じたコントロールがページ上にレンダリングされないのに対し、非表示のコントロールは Web パーツ アプリケーションでレンダリングされアクティブになりますが、ユーザーには表示されないため、閉じている WebPart コントロールとは異なります。 Web パーツ コントロール セットは、カスケード スタイル シート (CSS) スタイルを display:none の値に設定することで、WebPart コントロールを非表示にします。

コントロールの Hidden プロパティが trueに設定されている場合でも、ページ上の現在の表示モードで非表示のコントロールを表示できる場合、コントロールは表示されます。 たとえば、ユーザーが編集できるように、編集モードでは非表示のコントロールを表示できます。 非表示のコントロールが特定の表示モードで表示されている場合、コントロールのタイトルには、コントロールが非表示状態であることを示す文字列が表示されます。

WebPart コントロールの Hidden プロパティが既定の false に設定されている場合、コントロールはページに表示されます。 AllowHide プロパティが false に設定されている場合、エンド ユーザーは Hidden プロパティ値を編集できません。

このプロパティは、テーマまたはスタイル シートのテーマでは設定できません。 詳細については、「テーマとスキンの ThemeableAttribute と ASP.NET」を参照してください。

適用対象

こちらもご覧ください