WebPart 클래스

정의

public ref class WebPart abstract : System::Web::UI::WebControls::WebParts::Part, System::Web::UI::WebControls::WebParts::IWebActionable, System::Web::UI::WebControls::WebParts::IWebEditable, System::Web::UI::WebControls::WebParts::IWebPart

public abstract class WebPart : System.Web.UI.WebControls.WebParts.Part, System.Web.UI.WebControls.WebParts.IWebActionable, System.Web.UI.WebControls.WebParts.IWebEditable, System.Web.UI.WebControls.WebParts.IWebPart

type WebPart = class
    inherit Part
    interface IWebPart
    interface IWebActionable
    interface IWebEditable

Public MustInherit Class WebPart
Inherits Part
Implements IWebActionable, IWebEditable, IWebPart

상속

Object

Control

WebControl

Panel

Part

WebPart

파생

System.Web.UI.WebControls.WebParts.GenericWebPart

System.Web.UI.WebControls.WebParts.ProxyWebPart

구현

IWebActionable IWebEditable IWebPart

예제

다음 코드 예제에서는 컨트롤을 WebPart 만들고 웹 페이지에서 참조하는 방법을 보여 줍니다.

예제의 첫 번째 부분에는 라는 TextDisplayWebPart사용자 지정 WebPart 컨트롤에 대한 코드가 포함되어 있습니다. 이 컨트롤은 웹 파트 컨트롤 집합의 기능에 액세스할 수 있는 간단한 사용자 지정 WebPart 컨트롤을 만드는 방법을 보여 줍니다. 코드 예제를 실행하려면 이 소스 코드를 컴파일해야 합니다. 명시적으로 컴파일하고 결과 어셈블리를 웹 사이트의 Bin 폴더 또는 전역 어셈블리 캐시에 넣을 수 있습니다. 또는 런타임에 동적으로 컴파일되는 사이트의 App_Code 폴더에 소스 코드를 배치할 수 있습니다. 이 코드 예제에서는 소스 코드를 어셈블리로 컴파일할 웹 애플리케이션의 Bin 하위 폴더에 배치 및 가정 사용 하 여 어셈블리 참조를 Register 웹 페이지 지시문입니다. 두 가지 컴파일 방법을 모두 보여 주는 연습은 연습: 사용자 지정 웹 서버 컨트롤 개발 및 사용을 참조하세요.

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;

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

    [Personalizable(), 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))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

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 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
            _contentText = input.Text & "<br />"
            input.Text = String.Empty
            DisplayContent.Text = Me.ContentText
        End If
    
    End Sub
    
End Class

End Namespace

이 예제의 두 번째 부분에서는 ASP.NET 웹 페이지에서 컨트롤을 참조 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" />
        </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" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

설명

웹 파트 기능을 사용하여 컨트롤을 만들 때는 두 가지 기본 옵션이 있습니다. 클래스에서 파생되는 사용자 지정 컨트롤을 WebPart 만들거나 다른 서버 컨트롤을 만들거나 사용할 수 있습니다. 기존 ASP.NET 컨트롤, 사용자 지정 서버 컨트롤 및 사용자 컨트롤은 모두 영역 컨트롤 내에서 선언(또는 프로그래밍 방식으로 에 추가) WebPartZone 하여 전체 웹 파트 기능을 제공할 수 있으며, 그 결과 런타임에 개체로 GenericWebPart 래핑되고 진정한 WebPart 컨트롤로 처리됩니다. 자세한 내용은 클래스에 대한 GenericWebPart 설명서를 참조하세요. 개발 속도와 코드의 최대 재사용을 위해 기존 서버 컨트롤을 사용하는 것이 좋습니다. 컨트롤의 동작 및 웹 파트 기능에 대한 프로그래밍 방식의 최대 제어를 위해 클래스에서 상속되는 사용자 지정 컨트롤을 WebPart 만드는 것이 가장 좋은 옵션인 경우가 많습니다.

추상 WebPart 클래스는 기본 Part 컨트롤에서 상속되며 모든 WebPart 컨트롤에 대한 기본 요소를 제공합니다. 클래스에는 UI의 모양에 영향을 주는 공통 속성 집합이 포함됩니다. 합니다 AllowClose, AllowConnect를 AllowEdit를 AllowHide를 AllowMinimize, 및 AllowZoneChange 속성에는 각 웹 애플리케이션의 사용자 지정된 된 속성에 나타난 방식에서 파트 컨트롤을 사용 하 여 상호 작용 하도록 허용 되는지 여부를 지정 이름입니다. , , ChromeState, ChromeType, Description, Height, HelpUrl, Hidden, Title, , TitleIconImageUrl, TitleUrl및 Width 속성은 CatalogIconImageUrl컨트롤의 크기, 표시 유형, 모양 및 지원 콘텐츠(예: 제목 및 설명)를 WebPart 결정합니다.

웹 파트 컨트롤 집합 내의 컨텍스트에 대한 컨트롤의 관계는 컨트롤의 WebPart 연결된 WebPartManager 개체에 대한 참조를 보유하는 및 컨트롤이 포함된 를 참조 WebZone 하는 와 Zone같은 WebPartManager속성에 의해 결정됩니다. 페이지당 하나의 WebPartManager 컨트롤만 있을 수 있으며 컨트롤의 WebPart 각 instance 한 번에 하나 WebZone 만 있을 수 있습니다.

다른 몇 가지 중요한 속성은 컨트롤의 WebPart 고유한 기능에 영향을 줍니다. 이 AuthorizationFilter 속성을 사용하면 개발자가 런타임에 필터로 사용할 수 있는 임의의 문자열을 설정하여 컨트롤이 페이지에 추가되는지 여부를 확인할 수 있습니다. 역할 관리와 같은 기능과 함께 사용되는 속성은 AuthorizationFilter 정의된 사용자 역할을 기반으로 보기를 만드는 데 유용한 메커니즘을 제공합니다. 속성은 ExportMode 내보내는 동안 컨트롤에서 사용 가능한 모든 속성 데이터를 내보낼지 아니면 민감하지 않은 데이터만 내보낼지 여부를 나타냅니다. 이를 통해 개발자는 보안을 위해 중요한 데이터와 그렇지 않은 데이터를 구분할 수 있습니다. 속성은 WebBrowsableObject 컨트롤의 instance 대한 참조를 WebPart 반환하므로 페이지가 편집 모드일 EditorPart 때 컨트롤을 편집할 수 있습니다. 마지막으로 페이지의 나머지 부분을 기준으로 컨트롤의 상태 나타내는 몇 가지 속성이 있습니다. 속성은 IsClosed 컨트롤이 닫혀 있고 개체에 PageCatalogPart 추가되었는지 또는 페이지에서 열려 있고 사용할 수 있는지 여부를 나타냅니다. 속성은 IsShared 컨트롤이 공유 컨트롤인지(사용자별 컨트롤과 비교) 웹 페이지의 모든 사용자에게 표시되는지 여부를 나타냅니다. 속성은 IsStandalone 컨트롤이 현재 파생 영역(예: WebPartZone)에 WebPartZoneBase포함되어 있는지 여부를 나타냅니다. 값은 false 컨트롤이 영역 내에 있으므로 전체 웹 파트 기능이 있음을 나타냅니다. 속성은 IsStatic 컨트롤이 정적인지 동적인지 여부를 나타냅니다. 정적 컨트롤은 웹 페이지의 태그에 선언된 반면 동적 컨트롤은 프로그래밍 방식으로 추가됩니다.

또한 클래스는 WebPart 컨트롤의 수명 주기에서 다양한 지점에서 발생하는 일을 결정하는 여러 메서드를 제공합니다. 예를 들어 OnConnectModeChanged 및 OnEditModeChanged 메서드는 파생 클래스에서 재정의되어 각 메서드의 이름에 해당하는 이벤트 중에 컨트롤의 콘텐츠 렌더링을 프로그래밍 방식으로 제어할 수 있습니다.

에서 WebPart 파생되는 클래스는 컬렉션에 개체를 Verbs 추가할 WebPartVerb 수 있습니다. 동사는 컨트롤의 제목 표시 WebPart 줄에 표시되는 동사 메뉴에서 렌더링됩니다. WebPartVerb 개체는 컨트롤을 숨기거나 최소화하거나 도움말을 표시하는 것과 같은 일반적인 사용자 작업을 위한 간단한 UI 요소를 제공합니다.

메서드는 CreateEditorParts 컨트롤과 WebPart 연결된 모든 사용자 지정 EditorPart 컨트롤의 컬렉션을 만듭니다. 개발자는 컨트롤을 편집하도록 특별히 설계된 사용자 지정 컨트롤을 만들 수 있도록 이 메서드를 재정의할 수 있습니다 WebPart . 메서드는 사용자가 컨트롤에서 편집 동사를 클릭할 때 호출됩니다 WebPart .

생성자

속성

메서드

이벤트

명시적 인터페이스 구현

확장 메서드

적용 대상

추가 정보

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