다음을 통해 공유

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

false 컨트롤이 WebPart 웹 페이지에 표시되면 이고, 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.

적용 대상

추가 정보