WebZone 클래스

정의

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl

[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl

[<System.ComponentModel.Bindable(false)>]
type WebZone = class
    inherit CompositeControl

Public MustInherit Class WebZone
Inherits CompositeControl

상속

Object

Control

WebControl

CompositeControl

WebZone

파생

System.Web.UI.WebControls.WebParts.ToolZone

System.Web.UI.WebControls.WebParts.WebPartZoneBase

특성

BindableAttribute

예제

다음 코드 예제에서는 사용 하는 클래스입니다 WebZone .

코드 예제의 첫 번째 부분은 클래스에서 파생되는 두 개의 사용자 지정 컨트롤을 WebPart 보여 줍니다. 코드 예제를 실행하려면 이 소스 코드를 컴파일해야 합니다. 명시적으로 컴파일하고 결과 어셈블리를 웹 사이트의 Bin 폴더 또는 전역 어셈블리 캐시에 넣을 수 있습니다. 또는 런타임에 동적으로 컴파일되는 사이트의 App_Code 폴더에 소스 코드를 배치할 수 있습니다. 두 가지 컴파일 방법을 모두 보여 주는 연습은 연습: 사용자 지정 웹 서버 컨트롤 개발 및 사용을 참조하세요.

using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class CalendarWebPart : WebPart
  {
    Calendar _calendar;

    public CalendarWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      _calendar = new Calendar();
      _calendar.Caption = "My Calendar";
      this.Controls.Add(_calendar);
      ChildControlsCreated = true;
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class LinksWebPart : WebPart
  {
    Literal _literal;
    const string _literalText = @"
      <table>
      <tr>
        <td><a href='http://msdn.microsoft.com'>MSDN</a></td>
      </tr>
      <tr>
        <td><a href='http://msn.microsoft.com'>MSN</a></td>
      </tr>
      <tr>
        <td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
      </tr>
      </table>";

    public LinksWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();

      _literal = new Literal();
      _literal.Text = _literalText;
      this.Controls.Add(_literal);

      ChildControlsCreated = true;
    }
  }
}

Imports System.Security.Permissions 
Imports System.Web
Imports System.Web.UI.WebControls 
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _ 
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
Public Class CalendarWebPart
  Inherits WebPart
  Private _calendar As Calendar

  Public Sub New()
    Me.AllowClose = False

  End Sub

  Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      _calendar = New Calendar()
      _calendar.Caption = "My Calendar"
      Me.Controls.Add(_calendar)
      ChildControlsCreated = True
  
  End Sub 
  
End Class 

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class LinksWebPart
    Inherits WebPart
    Private _literal As Literal
    Private Const _literalText As String = _
      "<table>" & _
      "<tr>" & _
      "<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
      "</tr>" & _
      "</table>"

    Public Sub New()
      Me.AllowClose = False

    End Sub


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      _literal = New Literal()
      _literal.Text = _literalText
      Me.Controls.Add(_literal)

      ChildControlsCreated = True

    End Sub
  End Class

End Namespace

코드 예제의 두 번째 부분에서는 컨트롤을 호스트 WebPart 하는 웹 페이지를 보여 줍니다. 선언적 태그에는 컨트롤과 컨트롤이라는 두 개의 WebPartZone 컨트롤이 CatalogZone 포함되어 있습니다 EditorZone .

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<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" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" 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:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<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" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" 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:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

브라우저에서 페이지를 로드하고 다양한 페이지 표시 모드 간에 전환하여 다른 영역이 어떻게 작동하는지 확인할 수 있습니다. 디스플레이 모드 및 사용자가 전환할 수 있도록 하는 방법에 대한 자세한 내용은 연습: 웹 파트 페이지에서 디스플레이 모드 변경을 참조하세요.

설명

웹 파트 영역은 웹 페이지의 서버 컨트롤을 포함하고 포함된 컨트롤에 대해 일관된 UI(사용자 인터페이스), 레이아웃 및 렌더링을 제공하는 정의된 지역입니다. 영역은 브라우저에서 HTML 테이블로 렌더링됩니다.

클래스는 WebZone 모든 웹 파트 영역에 대한 기본 클래스입니다. 영역 컨트롤은 다른 컨트롤을 포함하도록 설계된 복합 컨트롤이므로 클래스는 WebZone 클래스에서 CompositeControl 상속됩니다. 와 함께 합니다 WebPartManager 컨트롤 및 Part 컨트롤 (또는 영역에 배치할 수 있는 다른 사용자 또는 서버 컨트롤)에서 파생 된 컨트롤 영역을 WebZone 웹 파트 애플리케이션의 필수 구성 요소를 형성 하는 기본 클래스.

웹 파트 영역의 중요한 역할은 포함된 컨트롤에 대해 전체 웹 파트 기능을 사용하도록 설정하는 것입니다. 모든 웹 파트 페이지에는 하나 이상의 영역이 포함되며 영역에는 0개 이상의 부분 컨트롤이 포함될 수 있습니다. 영역은 웹 파트 기능에 필요합니다. 영역이 없으면 클래스에서 WebPart 파생된 컨트롤도 웹 파트 기능이 거의 없을 수 있습니다. 반대로 웹 파트 컨트롤 집합의 디자인으로 인해 일반 ASP.NET 컨트롤, 서버 컨트롤 또는 사용자 컨트롤 WebPartZoneBase 을 영역(에서 WebZone파생)에 배치할 수 있으며, 영역에 있으므로 이러한 일반 서버 컨트롤은 런타임에 컨트롤 역할을 WebPart 할 수 있습니다. 자세한 내용은 클래스에 대한 GenericWebPart 설명서를 참조하세요.

웹 파트 컨트롤 집합에는 두 가지 광범위한 영역 범주가 있으며, 모두 기본 WebZone 클래스에서 상속됩니다.

• WebPartZoneBase 영역. 여기에는 (및 기타 서버 및 사용자) 컨트롤이 포함 WebPart 되며 사용자가 대부분의 시간 동안 상호 작용하는 웹 파트 페이지의 기본 UI를 형성합니다.

• ToolZone 영역. 이러한 영역은 사용자가 웹 파트 페이지의 영역에 포함된 컨트롤의 콘텐츠, 레이아웃, 모양, 동작 및 속성을 수정(개인 설정)할 수 있는 WebPartZoneBase 웹 파트 페이지의 특별한 보기를 제공합니다. 예를 들어 CatalogZoneBase 영역은 ToolZone 페이지의 카탈로그 보기를 제공하여 사용자가 서버 컨트롤을 추가하고 제거할 수 있도록 하는 입니다. EditorZoneBase 영역은 페이지의 편집 보기를 제공하는 또 다른 형식 ToolZone 으로, 사용자가 컨트롤의 속성, 모양 및 동작과 함께 페이지의 레이아웃을 수정하고 편집할 수 있습니다.

웹 파트 컨트롤 집합의 각 영역은 클래스에서 Part 파생된 해당 형식의 컨트롤을 포함하도록 설계되었으며 파트 컨트롤은 영역의 기본 콘텐츠 및 기본 UI 역할을 합니다. 웹 파트 컨트롤 집합의 영역 형식과 해당 형식의 파트 컨트롤은 다음 표에 나와 있습니다.

웹 파트 컨트롤의 모든 영역에는 기본 WebZone 클래스에서 상속하는 기본 일반 사용자 인터페이스 요소가 있습니다. 이러한 모든 요소가 모든 영역에 표시되는 것은 아니지만 각 영역 유형은 다음 표에 설명된 대로 이러한 공통 영역 관련 UI 요소를 가질 수 있습니다.

WebZone 대부분의 클래스 속성은 영역의 일반적인 UI 요소를 설명하는 앞의 표에서 설명합니다. WebZone 또한 클래스에는 콘텐츠 렌더링의 역할과 관련된 여러 메서드가 있습니다. 영역RenderContents의 RenderBody각 특정 섹션의 렌더링을 프로그래밍 방식으로 제어할 수 있도록 , , RenderFooter및 RenderHeader 메서드를 모두 재정의할 수 있습니다. 예를 들어, 애플리케이션에서 카탈로그 영역의 모든 바닥글 섹션의 렌더링을 사용자 지정 하려는 경우 수에서 상속 하는 CatalogZoneBase 클래스를 재정의 합니다 RenderFooter 에서 상속 된 메서드 WebZone, 렌더링을 변경 하 고는 바닥글 섹션입니다.

구현자 참고

사용자 지정 웹 파트 영역을 개발하기 위해 클래스에서 WebZone 직접 상속할 필요가 거의 없습니다. 웹 파트 컨트롤 집합은 설명 섹션에 위에 나열된 특수 영역을 포함하며, 일반적으로 해당 영역 중 하나에서 파생되어 영역에 사용자 지정 동작을 추가할 수 있습니다. 클래스에서 WebZone 직접 상속하려는 경우 여러 속성 및 메서드를 재정의해야 합니다(클래스의 WebZone 멤버에 대한 설명서 참조). 또한 사용자 지정 WebPartManager 컨트롤, 필요에 따라 사용자 지정 WebPartDisplayMode 컨트롤을 만들어 영역을 볼 수 있는 고유한 표시 모드를 만들고 웹 파트 컨트롤 집합 내에서 영역을 작동하도록 하는 기타 사용자 지정을 만들어야 합니다.

속성

메서드

이벤트

명시적 인터페이스 구현

확장 메서드

적용 대상

추가 정보

• ASP.NET 웹 파트 개요
• 웹 파트 컨트롤 집합 개요
• 연습: 웹 파트 페이지에서 디스플레이 모드 변경
• ASP.NET 웹 파트 컨트롤