다음을 통해 공유

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

예제

다음 코드 예제에서는 사용 Hidden 하는 사용자 지정 웹 파트 컨트롤에 대 한 속성입니다. 이 예제에서는 클래스 개요의 예제 섹션에 있는 사용자 지정 컨트롤 TextDisplayWebPart을 사용하는 것으로 WebPart 가정합니다.

웹 페이지의 요소 Hidden 에 대한 <aspSample:TextDisplayWebPart> 선언적 태그에서 특성 값은 로 설정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 닫힌된 컨트롤은 렌더링 되지 않습니다도 페이지에 숨겨진된 컨트롤은 렌더링 및 웹 파트 애플리케이션에서 활성 사용자에 게 표시 되지 않습니다 하지만 때문에 접근할 수 있는 컨트롤입니다. 웹 파트 컨트롤 집합은 CSS(계단식 스타일시트) 스타일을 값display:none으로 설정하여 컨트롤을 숨깁니다WebPart.

컨트롤의 Hidden 속성이 로 설정되어 true있더라도 페이지의 현재 표시 모드에서 숨겨진 컨트롤을 표시할 수 있는 경우에도 컨트롤이 계속 표시됩니다. 예를 들어 편집 모드에서는 사용자가 편집할 수 있도록 숨겨진 컨트롤을 표시할 수 있습니다. 숨겨진 컨트롤이 특정 표시 모드에서 표시되면 컨트롤 제목에 컨트롤이 숨겨진 상태임을 나타내는 문자열이 표시됩니다.

컨트롤의 Hidden 속성 WebPart 이 기본값인 로 false설정되면 컨트롤이 페이지에 표시됩니다. 속성이 로 AllowHide 설정된 false경우 최종 사용자는 속성 값을 편집 Hidden 할 수 없습니다.

이 속성은 테마 또는 스타일시트 테마에 의해 설정될 수 없습니다. 자세한 내용은 ThemeableAttribute 하 고 ASP.NET 테마 및 스킨합니다.

적용 대상

추가 정보