Part 클래스

정의

public ref class Part abstract : System::Web::UI::WebControls::Panel, System::Web::UI::INamingContainer, System::Web::UI::WebControls::ICompositeControlDesignerAccessor

public abstract class Part : System.Web.UI.WebControls.Panel, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessor

type Part = class
    inherit Panel
    interface INamingContainer
    interface ICompositeControlDesignerAccessor

Public MustInherit Class Part
Inherits Panel
Implements ICompositeControlDesignerAccessor, INamingContainer

상속

Object

Control

WebControl

Panel

Part

파생

System.Web.UI.WebControls.WebParts.CatalogPart

System.Web.UI.WebControls.WebParts.EditorPart

System.Web.UI.WebControls.WebParts.WebPart

구현

INamingContainer ICompositeControlDesignerAccessor

예제

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

예제의 첫 번째 부분에는 라는 TextDisplayWebPart사용자 지정 컨트롤에 대한 코드가 포함되어 있습니다. 컨트롤은 에서 WebPart파생되므로 클래스가 Part 제공하는 공통 속성도 상속하고 이 코드 예제에서 이러한 속성의 사용을 보여 줍니다.

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 TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    const string _subTitle = "Contoso, Ltd";

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

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

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = 
        System.Drawing.Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);
      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);
      ChildControlsCreated = true;
    }

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

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

<AspNetHostingPermission(SecurityAction.Demand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    
    
    Public Sub New() 
      Me.AllowClose = False
    End Sub
    
    <Personalizable(), WebBrowsable()>  _
    Public Property ContentText() As String 
        Get
            Return _contentText
        End Get
        Set
            _contentText = value
        End Set
    End Property
     
    Protected Overrides Sub CreateChildControls() 
        Controls.Clear()
        DisplayContent = New Label()
        DisplayContent.Text = Me.ContentText
        DisplayContent.BackColor = _
          System.Drawing.Color.LightBlue
        Me.Controls.Add(DisplayContent)
        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)
        ChildControlsCreated = True
    
    End Sub
    
    
    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs) 
        ' Update the label string.
        If input.Text <> String.Empty Then
            Me.ContentText = Page.Server.HtmlEncode(input.Text) + "<br />"
            ' Clear the input textbox.
            input.Text = String.Empty
            DisplayContent.Text = Me.ContentText
        End If
    
    End Sub
    
End Class

End Namespace

예제의 두 번째 부분에서는 ASP.NET 웹 페이지에서 사용자 지정 파트 컨트롤을 참조하는 방법을 보여 줍니다. 다양한 Part 속성이 사용자 지정 컨트롤 인스턴스에 선언적으로 할당됩니다. 페이지에서 두 인스턴스를 참조하는 선언적 코드를 비교한 다음 브라우저에서 페이지를 로드합니다. 다양한 속성이 컨트롤의 모양에 어떤 영향을 주는지 확인합니다. 예를 들어 브라우저에서 페이지를 로드한 후 해당 속성 값이 로 설정Minimized되므로 컨트롤의 TextDisplayWebPart 두 번째 instance 최소화된 ChromeState 것으로 나타납니다.

<%@ 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"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </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"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

설명

클래스는 Part 모든 파트 컨트롤에 공통적인 속성을 정의하고 웹 페이지에서 모듈식과 일관된 모양을 가질 수 있도록 합니다. 이러한 일반적인 속성에는 파트 컨트롤을 둘러싸는 크롬이나 프레임의 제목, 설명 및 특성이 포함됩니다.

속성은 Title 파트 컨트롤의 제목을 지정합니다. 속성은 Description 파트 컨트롤의 용도를 요약하는 데 사용되며 컨트롤의 제목 표시줄에 도구 설명으로 표시됩니다. 속성은 ChromeType 파트 컨트롤 주위에 렌더링되는 테두리 종류를 지정하는 반면 ChromeState , 속성은 파트 컨트롤이 정상적으로 렌더링되는지 또는 최소화되는지를 나타냅니다. 파트 컨트롤의 테두리는 해당 컨트롤을 포함하는 영역의 속성에 의해 영향을 받습니다. 예를 들어 속성은 PartChromeType 영역에 포함된 모든 파트 컨트롤의 프레임에 영향을 줍니다.

파트 컨트롤의 한 가지 유형은 WebPart 해당 영역 내에서 콘텐츠를 렌더링하는 컨트롤입니다. 또 다른 형식은 개별 WebPart 컨트롤을 EditorPart 수정(개인 설정)하는 데 사용되는 UI(사용자 인터페이스) 컨트롤을 제공하는 컨트롤입니다. 파트 컨트롤의 세 번째 유형은 CatalogPart 사용자가 웹 페이지에서 추가하거나 제거할 수 있는 컨트롤 목록을 WebPart 제공하는 컨트롤입니다.

파트 컨트롤은 모두 추상 WebZone 클래스에서 파생되는 영역에 포함됩니다. 영역은 포함된 파트 컨트롤을 구성해야 합니다. 또한 각 영역은 머리글, 바닥글, 제목 표시줄 및 테두리와 같은 포함된 각 파트 컨트롤 주위의 UI 요소를 포함하여 자체에 대한 UI 요소를 렌더링합니다.

기본 파트 형식 및 해당 영역 형식의 몇 가지 예는 다음 표에 나와 있습니다.

클래스에서 Part 파생되는 다양한 종류의 파트 컨트롤은 상속된 UI 지향 속성을 다르게 처리합니다. WebPart컨트롤은 상속된 UI 속성 중 몇 가지를 재정의하고 특성(자세한 내용은 클래스 설명서 참조PersonalizableAttribute)으로 Personalizable 표시합니다. 이를 통해 이러한 속성의 값을 이후 브라우저 세션에 저장할 수 있습니다( 개인 설정이라고 하는 기능). 예를 들어 사용자가 런타임에 컨트롤의 WebPartTitle 속성 값을 업데이트하도록 프로그래밍 방식으로 사용하도록 설정하면 해당 값이 개인 설정됩니다(개인 설정이 사용하도록 설정된 경우 기본값임). 컨트롤이 클래스 및 클래스에서 PartWebControl 상속하는 WebPart 여러 UI 속성은 동일한 방식으로 처리됩니다.

반면, 및 와 CatalogPart같은 EditorPart 다른 파트 컨트롤은 상속된 UI 속성을 개인 설정할 수 없습니다. 이러한 이유로 프로그래밍 방식으로 할당된 속성 값은 이후 브라우저 세션에 대해 저장되지 않습니다. 예를 들어 사용자가 런타임에 컨트롤의 Title 속성을 업데이트 PropertyGridEditorPart 하도록 프로그래밍 방식으로 사용하도록 설정하면 컨트롤이 닫히거나 브라우저 세션이 종료된 후 업데이트된 값이 손실됩니다.

이후 브라우저 세션에 대한 EditorPart 및 CatalogPart 컨트롤의 상속된 UI 속성에 대한 값을 저장하는 쉬운 방법은 속성 값을 페이지 지속성 형식으로 선언하는 것입니다. 그러나 이는 정적 접근 방식이며 사용자가 속성 값을 개인 설정할 수 없습니다. 또는 사용자가 런타임에 개인 설정할 수 있도록 상속된 UI 속성에 프로그래밍 방식으로 업데이트를 사용하도록 설정하려는 경우 프라이빗 정적 변수를 사용하여 속성 값을 저장할 수 있습니다. 또는 CatalogPart 컨트롤의 EditorPart 새 instance 만들 때마다(예: 컨트롤의 Init 이벤트를 처리하는 메서드에서) 정적 변수의 값을 해당 속성에 다시 할당할 수 있습니다. 이러한 방식은 사용자 편집 UI 및 웹 파트 애플리케이션의 UI 카탈로그를 개인 설정 하는 기능을 제공 합니다.

구현자 참고

일반적으로 사용자 지정 웹 파트 컨트롤을 Part 개발하기 위해 클래스에서 직접 상속해서는 안 됩니다. 전체 웹 파트 기능을 제공하려면 웹 파트 컨트롤 집합에 클래스, 즉 WebPart, EditorPart및 CatalogPart에서 Part 파생된 클래스가 필요하므로 사용자 지정 컨트롤을 개발하기 위해 해당 클래스에서 파생되어야 합니다. 그러나 다른 모든 파트 클래스에서 사용되는 공통 속성 집합을 제공하기 때문에 기본 Part 클래스의 동작을 이해하는 것이 여전히 중요합니다.

속성

메서드

이벤트

명시적 인터페이스 구현

확장 메서드

적용 대상

추가 정보

• ASP.NET 웹 파트 개요
• 웹 파트 컨트롤 집합 개요
• 웹 파트 컨트롤 ASP.NET