CatalogZone 클래스

정의

public ref class CatalogZone : System::Web::UI::WebControls::WebParts::CatalogZoneBase

public class CatalogZone : System.Web.UI.WebControls.WebParts.CatalogZoneBase

type CatalogZone = class
    inherit CatalogZoneBase

Public Class CatalogZone
Inherits CatalogZoneBase

상속

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

CatalogZoneBase

CatalogZone

예제

다음 코드 예제에서는 선언적 및 프로그래밍 방식으로 사용 하는 컨트롤입니다 CatalogZone . 코드 예제에는 네 부분으로 구성됩니다.

• 웹 페이지의 디스플레이 모드를 변경할 수 있게 해 주는 사용자 정의 컨트롤입니다.

• 사용자 지정 CatalogZone 컨트롤에 대한 소스 코드와 카탈로그에서 가져와 웹 페이지에 추가되는 사용자 지정 WebPart 컨트롤이 있는 파일입니다.

• 사용자 컨트롤 및 사용자 지정 CatalogZone 컨트롤을 선언하는 웹 페이지입니다.

• 예제를 실행하는 방법에 대한 설명입니다.

이 코드 예제에 첫 번째 부분은 사용자가 웹 페이지의 디스플레이 모드를 변경할 수 있는 사용자 정의 컨트롤입니다. 표시 모드 및 이 컨트롤의 소스 코드에 대한 설명에 대한 자세한 내용은 연습: 웹 파트 페이지에서 디스플레이 모드 변경을 참조하세요.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

코드 예제의 두 번째 부분에는 사용자 지정 CatalogZone 및 WebPart 컨트롤에 대한 코드가 포함되어 있습니다. 컨트롤의 CatalogZone 코드는 클래스에서 상속하고 생성자에서 CatalogZone 일부 기본 속성 값을 설정하여 해당 속성을 사용자 지정하는 방법을 보여 줍니다. 소스 코드는 라는 TextDisplayWebPart사용자 지정 WebPart 클래스를 만드는 방법도 보여 줍니다. 와 연결된 컨트롤입니다. 이 코드 예제의 일부로 가져올 WebPart 설명 파일입니다. 웹 페이지의 컨트롤을 ImportCatalogPart 사용하여 설명 파일을 가져온 후에는 설명 파일에 지정된 대로 완전히 미리 구성된 컨트롤을 페이지에 추가할 TextDisplayWebPart 수 있습니다.

코드 예제를 실행하려면 이 소스 코드를 컴파일해야 합니다. 명시적으로 컴파일하고 결과 어셈블리를 웹 사이트의 Bin 폴더 또는 전역 어셈블리 캐시에 넣을 수 있습니다. 또는 런타임에 동적으로 컴파일되는 사이트의 App_Code 폴더에 소스 코드를 배치할 수 있습니다. 이 코드 예제에서는 동적 컴파일,이 방법은 예제를 실행 하려는 경우 소스 코드 파일 이름과 웹 애플리케이션의 루트 디렉터리의 App_Code 하위 폴더에 추가 합니다. 두 가지 컴파일 방법을 모두 보여 주는 연습은 연습: 사용자 지정 웹 서버 컨트롤 개발 및 사용을 참조하세요.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  // Create a customized CatalogZone control by setting 
  // some properties in the constructor.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyCatalogZone : CatalogZone
  {
    public MyCatalogZone()
    {
      this.HeaderText = "My Company Catalog";
      this.HeaderCloseVerb.Text = "Close Catalog";
      this.CloseVerb.Text = "Close Catalog";
    }
  }

  // Create a custom WebPart control to add to a WebPartZone.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    Literal lineBreak;

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  ' Create a custom CatalogZone control by setting some 
  ' properties in the constructor.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class MyCatalogZone
    Inherits CatalogZone

    Public Sub New()
      Me.HeaderText = "My Company Catalog"
      Me.HeaderCloseVerb.Text = "Close Catalog"
      Me.CloseVerb.Text = "Close Catalog"
    End Sub

  End Class


  ' Create a custom WebPart to add to a WebPartZone.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      input = New TextBox()
      Me.Controls.Add(input)
      Dim update As New Button()
      update.Text = "Set Label Content"
      AddHandler update.Click, AddressOf Me.submit_Click
      Me.Controls.Add(update)

    End Sub

    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs)
      ' Update the label string.
      If input.Text <> String.Empty Then
        _contentText = input.Text + "<br />"
        input.Text = String.Empty
        DisplayContent.Text = Me.ContentText
      End If

    End Sub

  End Class

End Namespace

코드 예제의 세 번째 부분은 컨트롤을 포함하는 웹 페이지입니다. 사용자 정의 컨트롤에 Register 대한 지시문과 사용자 지정 컨트롤이 있는 원본 파일에 대한 지시문이 포함되어 있습니다. 두 번째 지시문에서는 어셈블리 이름을 지정하지 않습니다. 이 예제에서는 어셈블리를 사용하지 않으므로 App_Code 하위 폴더에 배치된 소스 코드와 함께 동적 컴파일을 사용합니다. 웹 페이지는 컨트롤을 WebPartZone 선언하고 해당 자식 <zonetemplate> 요소 내에서 컨트롤을 BulletedList 선언합니다. 표준 ASP.NET 컨트롤 이지만, 더 완전 한 웹 파트 기능 런타임에 때문에 합니다 WebPartManager 래핑하고 서버 컨트롤에 배치를 제어를 WebPartZone 사용 하 여를 GenericWebPart 개체를 다른 서버 컨트롤은 웹에 참여할 수 있도록 일부 애플리케이션입니다. 또한 이 영역에 선언된 은 라는 TextDisplayWebPart사용자 지정 WebPart 컨트롤입니다. 이 컨트롤에는 선언된 의 특성 ExportMode="All" 이 있습니다. 이렇게 하면 를 내보낼 수 있습니다. 미리 구성된 컨트롤을 다른 웹 페이지에 추가하기 위해 다른 사용자가 가져올 수 있는 컨트롤의 속성 값이 포함된 WebPart 설명 파일입니다.

또한 웹 페이지는 사용자 지정 CatalogZone 컨트롤을 선언하고 그 <zonetemplate> 안에 컨트롤이 포함된 요소를 선언합니다 ImportCatalogPart . 사용자는 런타임에 이 컨트롤을 사용하여 를 가져옵니다. 사용자 지정 WebPart 컨트롤에 대한 WebPart 설명 파일입니다.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.CS.Controls" %> 
  
<!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 runat="server">
    <title>Untitled Page</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">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.VB.Controls"  %> 

<!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 runat="server">
    <title>Untitled Page</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">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

이제 코드 예제를 실행합니다. 브라우저에서 웹 페이지를 로드합니다. 첫 번째 단계는 를 내보내는 것입니다. 컨트롤에 대한 WebPart 설명 파일입니다 TextDisplayWebPart . 사용자 지정 컨트롤(제목 표시줄의 아래쪽 화살표로 표시됨)에서 동사 메뉴를 클릭하고 내보내기를 클릭합니다. 지침에 따라 컨트롤에 대한 설명 파일을 저장합니다. 을 엽니다. 편집기에서 WebPart 설명 파일을 만들고 제목 속성 텍스트의 값을 편집합니다. <property> 특성name="Title"이 있는 요소를 찾고 여는 태그와 닫 <property> 는 태그 사이에 포함된 제목 텍스트를 편집합니다. 이제 웹 페이지를 닫고 편집기에서 페이지 원본을 편집합니다. <aspSample:TextDisplayWebPart> 컨트롤 선언 요소를 삭제한 다음 파일을 저장하고 닫습니다.

브라우저에서 웹 페이지를 다시 로드합니다. 컨트롤을 TextDisplayWebPart 제거했기 때문에 컨트롤이 표시되지 않아야 합니다. 표시 모드 드롭다운 목록 컨트롤을 사용하고 카탈로그를 선택하여 페이지를 카탈로그 모드로 전환합니다. 컨트롤과 함께 사용자 지정 CatalogZone 컨트롤이 ImportCatalogPart 나타납니다. 찾아보기 단추를 클릭하여 를 찾습니다. 컨트롤에 대해 내보낸 WebPart 설명 파일입니다TextDisplayWebPart. 업로드를 클릭하고 가져온 컨트롤 옆에 있는 검사 상자를 선택한 다음 추가를 클릭하여 페이지에 추가할 수 있습니다. 카탈로그 닫기를 클릭하여 페이지를 일반 찾아보기 모드로 반환합니다. 가져온 컨트롤이 이제 페이지에 나타나야 하며 컨트롤의 제목 표시줄에 나타나는 제목은 에 추가한 제목 텍스트여야 합니다. WebPart 설명 파일입니다.

설명

웹 파트 컨트롤 집합 내에서 영역은 웹 파트 컨트롤이 포함된 웹 페이지의 영역입니다. 웹 파트 영역은 다른 컨트롤을 포함하도록 설계된 형식인 CompositeControl 영역 컨트롤에 의해 만들어집니다. 영역의 주 함수에는 포함 된 컨트롤을 배치 하 고 해당 컨트롤에 대 한 공통 사용자 인터페이스 (UI)를 제공 하는입니다. 영역 및 웹 파트 애플리케이션에서 사용 되는 방법에 대 한 일반 정보에 대 한 자료 문서를 참조 WebZone 클래스 및 웹 파트 컨트롤 집합 개요합니다.

웹 파트 컨트롤의 주요 기능은 최종 사용자가 기본 설정에 따라 웹 페이지를 수정(또는 개인 설정)하고 향후 브라우저 세션을 위해 개인 설정된 설정을 저장할 수 있도록 허용한다는 것입니다. 웹 파트 페이지를 수정하는 한 가지 측면은 웹 파트 페이지에 컨트롤 또는 다른 서버 컨트롤을 추가하는 WebPart 기능을 포함합니다. 컨트롤은 CatalogZone 사용자가 페이지에 추가할 수 있는 컨트롤의 목록 또는 카탈로그를 제공합니다.

CatalogZone 컨트롤은 웹 파트 컨트롤 집합에 있는 기본 컨트롤 중 하나입니다. 클래스에서 CatalogZoneBase 파생되며 대부분의 동작은 해당 클래스에서 상속됩니다. 클래스는 CatalogZone 기본적으로 기본 클래스에 인터페이스의 구현인 영역 템플릿을 ITemplate 추가합니다. 영역 템플릿을 사용하면 개발자가 페이지 지속성 형식의 영역에 컨트롤을 선언적으로 추가할 CatalogPart 수 있습니다.

CatalogZone 사용자가 웹 페이지를 카탈로그 표시 모드(CatalogDisplayMode)로 전환할 때만 컨트롤이 표시됩니다. 카탈로그에는 여러 유형의 CatalogPart 컨트롤이 포함될 수 있습니다. 각 CatalogPart 컨트롤은 사용자가 페이지에 추가할 수 있는 서버 컨트롤을 포함하는 컨테이너의 유형입니다. 컨트롤은 CatalogPart 포함된 서버 컨트롤의 원본 위치에 따라 다릅니다. 다음 표에는 웹 파트 컨트롤 집합과 함께 제공되는 컨트롤과 각 컨트롤에 대해 포함된 서버 컨트롤의 종류가 요약 CatalogPart 되어 있습니다.

클래스는 CatalogZone 기본 클래스의 동작에 영역 템플릿만 추가하므로 멤버가 거의 없습니다. CatalogZone 생성자는 매개 변수가 없는 생성자입니다. 이 생성자를 사용하여 클래스의 CatalogZone 새 instance 초기화할 수 있습니다. 속성은 ZoneTemplate 영역에 대한 컨트롤을 포함하는 개체에 ITemplate 대한 참조를 가져오거나 설정합니다. 메서드가 CreateCatalogParts 중요합니다. 기본 메서드를 재정의하여 영역 템플릿 내에 포함된 모든 CatalogPart 컨트롤의 컬렉션을 만듭니다.

접근성

이 컨트롤에 대해 기본적으로 렌더링 되는 태그 내게 필요한 옵션 웹 콘텐츠 액세스 가능성 지침 1.0 WCAG 우선 순위 1 지침 등을 따르지 않을 수도 있습니다. 이 컨트롤에 대 한 내게 필요한 옵션 지원에 대 한 자세한 내용은 참조 하세요 ASP.NET 컨트롤 및 내게 필요한 옵션합니다.

상속자 참고

카탈로그 UI의 렌더링 및 동작을 더 자세히 제어하려면 사용자 지정 CatalogZone 클래스를 만들 수 있습니다. 컨트롤을 선언적으로 추가할 CatalogPart 수 있는 기능을 컨트롤 사용자에게 제공할 필요가 없는 경우 클래스에서 직접 상속할 CatalogZoneBase 수 있습니다. 컨트롤을 선언적으로 추가할 수 있도록 하려는 경우 간단한 방법은 필수 영역 템플릿을 제공하므로 클래스에서 CatalogZone 상속하는 것입니다.

클래스에서 상속하는 경우 메서드를 재정의 CatalogZoneCreateCatalogParts() 하고 메서드를 사용하여 사용자 지정 컨트롤을 CatalogPartCollection에 추가할 수 있습니다. 영역에 사용자 지정 CatalogPartCatalogPart 컨트롤을 추가하는 방법을 보다 프로그래밍 방식으로 제어하려는 경우 입니다.

생성자

속성

메서드

이벤트

명시적 인터페이스 구현

확장 메서드

적용 대상

추가 정보

• CatalogPart
• 웹 파트 컨트롤 집합 개요
• 웹 파트 개인 설정 개요
• 웹 파트 컨트롤 ASP.NET