WebPartVerb 클래스

정의

public ref class WebPartVerb : System::Web::UI::IStateManager

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.EmptyStringExpandableObjectConverter))]
public class WebPartVerb : System.Web.UI.IStateManager

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.EmptyStringExpandableObjectConverter))>]
type WebPartVerb = class
    interface IStateManager

Public Class WebPartVerb
Implements IStateManager

상속

Object

WebPartVerb

특성

TypeConverterAttribute

구현

IStateManager

예제

다음 코드 예제에서는 사용자 지정 WebPartVerb 개체를 만드는 방법을 보여 줍니다 및 사용자 지정 영역을 사용 하 여 OnCreateVerbs 동사를 추가 하는 메서드는 영역에 포함 된 각 WebPart 컨트롤의 동사 메뉴입니다. 코드 예제에는 다음과 같은 네 가지 부분이 있습니다.

• 일부 텍스트를 표시하는 간단한 사용자 지정 WebPart 컨트롤이 포함된 소스 파일입니다.

• 사용자 지정 WebPartVerb 개체를 포함하는 소스 파일 및 메서드를 재정의 OnCreateVerbs 하는 간단한 사용자 지정 WebPartZoneBase 영역이 영역의 컨트롤에 사용자 지정 동 WebPart 사를 추가합니다.

• 사용자 지정 영역 및 사용자 지정 컨트롤이 WebPart 포함된 웹 페이지입니다.

• 예제의 작동 방식을 설명 합니다.

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

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Collections.Generic;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{

    // This code snippet creates a simple Web Part control.
    [AspNetHostingPermission(SecurityAction.Demand,
      Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand,
      Level = AspNetHostingPermissionLevel.Minimal)]
    public class SimpleControl : WebPart
    {

        private String _text = "Simple control text";

        public string Text
        {
            get
            {
                if (_text != null)
                    return _text;
                else
                    return string.Empty;
            }
            set { _text = value; }
        }

        protected override void Render(System.Web.UI.HtmlTextWriter 
      writer)
        {
            writer.Write(this.Text);
        }
    }
}

Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Collections.Generic
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

' This code snippet creates a simple Web Part control.
Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class SimpleControl
    Inherits System.Web.UI.WebControls.WebParts.WebPart

    Private _text As String = "Simple control text"

    Public Property [Text]() As String
      Get
        If Not (_text Is Nothing) Then
          Return _text
        Else
          Return String.Empty
        End If
      End Get
      Set(ByVal value As String)
        _text = value
      End Set
    End Property

    Protected Overrides Sub Render(ByVal writer _
      As System.Web.UI.HtmlTextWriter)

      writer.Write(Me.Text)

    End Sub

  End Class

End Namespace

예제의 두 번째 부분에는 사용자 지정 영역 및 사용자 지정 개체를 만드는 소스 코드가 WebPartVerb 포함되어 있습니다. 영역은 메서드를 재정의 OnCreateVerbs 하여 영역의 모든 WebPart 컨트롤에 사용자 지정 동사를 추가합니다. 동사는 기본적으로 컨트롤의 동사 메뉴에 추가됩니다. 사용자 지정 동사에 대한 코드에서 동사의 생성자는 서버 클릭 처리기를 사용하며 호출된 메서드는 클래스에서 WebPart 직접 상속되는 모든 컨트롤의 전체 복사본을 만들어 새로 만든 복사본을 동일한 영역에 추가합니다. 코드 예제의 첫 번째 부분과 마찬가지로 이 소스 코드를 컴파일해야 하며, 이 예제에서는 소스 파일을 동적으로 컴파일할 App_Code 하위 폴더에 배치했습니다.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Collections.Generic;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{
/* 
This code sample creates a Web Part zone and adds the 
"Copy Web Part" verb to any control in the zone.
*/
[AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
public class ZoneWithAddedVerb : WebPartZone
{

  protected override void OnCreateVerbs(WebPartVerbsEventArgs e)
  {
    List<WebPartVerb> newVerbs = new List<WebPartVerb>();
    newVerbs.Add(new CopyWebPartVerb(CopyWebPartToNewOne));
    e.Verbs = new WebPartVerbCollection(e.Verbs,newVerbs);
    base.OnCreateVerbs(e);
  }

  void CopyWebPartToNewOne(object sender, WebPartEventArgs e)
  {
    WebPartManager wpmgr = 
      WebPartManager.GetCurrentWebPartManager(Page);
    System.Web.UI.WebControls.WebParts.WebPart wp;
    Type tp = e.WebPart.GetType(); 
    wp = (System.Web.UI.WebControls.WebParts.WebPart)Activator.CreateInstance(tp);   
    wpmgr.AddWebPart(wp, e.WebPart.Zone, e.WebPart.ZoneIndex + 1);
  }
}
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  internal class CopyWebPartVerb : WebPartVerb
  {
    private const String _copyWebPartImageUrl = "~/CopyVerb.ico";

    internal CopyWebPartVerb(WebPartEventHandler serverClickHandler) :  
       base("MyVerb", serverClickHandler)
    { }
    public override string Text
    {
      get { return "Copy Web Part"; }
      set { ;}
    }
    public override string Description
    {
      get { return "This verb will copy this web part control " +
        "to a new one below"; }
      set { ; }
    }
    public override bool Enabled
    {
      get { return base.Enabled; }
      set { base.Enabled = value; }
    }
    
    public override string ImageUrl
    {
      get { return _copyWebPartImageUrl; }
      set { ; }
    }
  }
}

Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Collections.Generic
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

' This code sample creates a Web Part zone and adds the 
' "Copy Web Part" verb to any control in the zone.
Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZoneWithAddedVerb
    Inherits WebPartZone

    'public class ExtendedWebPartZoneBase 
    Protected Overrides Sub OnCreateVerbs(ByVal e _
      As WebPartVerbsEventArgs)

      Dim newVerbs As List(Of WebPartVerb) = _
        New List(Of WebPartVerb)
      newVerbs.Add(New CopyWebPartVerb(AddressOf CopyWebPartToNewOne))
      e.Verbs = New WebPartVerbCollection(e.Verbs, newVerbs)
      MyBase.OnCreateVerbs(e)

    End Sub


    Sub CopyWebPartToNewOne(ByVal sender As Object, _
      ByVal e As WebPartEventArgs)

      Dim wpmgr As WebPartManager = _
        WebPartManager.GetCurrentWebPartManager(Page)
      Dim wp As System.Web.UI.WebControls.WebParts.WebPart
      Dim tp As Type = e.WebPart.GetType()
      wp = CType(Activator.CreateInstance(tp), _
        System.Web.UI.WebControls.WebParts.WebPart)
      wpmgr.AddWebPart(wp, e.WebPart.Zone, e.WebPart.ZoneIndex + 1)

    End Sub

  End Class


  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Friend Class CopyWebPartVerb
    Inherits WebPartVerb
    Private Const _copyWebPartImageUrl As String = "~/CopyVerb.ico"

    Friend Sub New(ByVal serverClickHandler As WebPartEventHandler)
      MyBase.New("MyVerb", serverClickHandler)

    End Sub

    Public Overrides Property [Text]() As String
      Get
        Return "Copy Web Part"
      End Get
      Set(ByVal value As String)
      End Set
    End Property

    Public Overrides Property Description() As String
      Get
        Return "This verb will copy this web part control to a " _
               & "new one below"
      End Get
      Set(ByVal value As String)
      End Set
    End Property

    Public Overrides Property Enabled() As Boolean
      Get
        Return MyBase.Enabled
      End Get
      Set(ByVal value As Boolean)
        MyBase.Enabled = value
      End Set
    End Property
    
    Public Overrides Property ImageUrl() As String
      Get
        Return Me._copyWebPartImageUrl
      End Get
      Set(ByVal value As String)
      End Set
    End Property

  End Class

End Namespace

코드 예제의 세 번째 부분은 컨트롤을 호스트하는 웹 페이지입니다. Register 페이지 위쪽에는 사용자 지정 컨트롤의 네임스페이스를 선언하는 지시문이 있습니다. 이 예제에서는 동적 컴파일을 사용하므로 어셈블리가 선언되지 않습니다. 사용자 지정 WebPart 컨트롤은 사용자 지정 영역 내에서 선언됩니다. 이 영역에서 다른 WebPart 컨트롤을 선언할 수도 있으며 사용자 지정 동사도 동사 메뉴에 추가됩니다.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="verbsample" 
    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" />
    <verbsample:ZoneWithAddedVerb id="ZoneWithAddedVerb1" 
      HeaderText="Zone with Added Verb" runat="server">
        <ZoneTemplate>
           <verbsample:SimpleControl id="SimpleControl1" 
            title="Simple Control" runat="server" /> 
        </ZoneTemplate>
        </verbsample:ZoneWithAddedVerb>
     </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Register TagPrefix="verbsample" 
    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" />
    <verbsample:ZoneWithAddedVerb id="ZoneWithAddedVerb1" 
      HeaderText="Zone with Added Verb" runat="server">
        <ZoneTemplate>
           <verbsample:SimpleControl id="SimpleControl1" 
            title="Simple Control" runat="server" /> 
        </ZoneTemplate>
        </verbsample:ZoneWithAddedVerb>
     </form>
</body>
</html>

브라우저에서 페이지를 로드하고 사용자 지정 WebPart 컨트롤에서 동사 메뉴를 클릭합니다. 웹 파트 복사 동사가 표시되어야 합니다. 동사를 클릭하고 컨트롤의 복사본이 영역에 추가됩니다.

설명

웹 파트 동사는 일반적으로 웹 파트 컨트롤을 사용하는 페이지에 표시되는 단추 또는 하이퍼링크로 표현되는 대화형 UI 요소입니다. 사용자는 동사를 클릭하여 컨트롤 닫기 또는 편집 표시 모드 닫기 WebPart (컨트롤과 연결된 특수 페이지 보기)와 같은 웹 파트 컨트롤에 EditorZone 대한 일반적인 UI 작업을 수행합니다. 웹 파트 컨트롤 집합과 함께 제공되는 모든 표준 동사는 웹 파트 영역(WebPartZone, , EditorZoneCatalogZone또는 ) 또는 ConnectionsZone웹 파트 Part 컨트롤(WebPart, , GenericWebPartEditorPart또는 CatalogPart)과 연결됩니다.

표준 동사가 영역과 연결된 경우 해당 작업은 영역 수준에서 적용되고 동사는 일반적으로 영역의 머리글 또는 바닥글 영역에 표시됩니다. 다음 표에서는 공통 영역 수준 동사를 나열하고 해당 작업에 대해 설명합니다.

컨트롤과 Part 연결된 표준 동사에 관해서는 해당 작업이 컨트롤 자체(또는 자식 컨트롤)에 적용됩니다. 파트 컨트롤은 동사의 컨테이너 역할을 하며 동사의 렌더링을 관리합니다. 파트 컨트롤과 연결된 대부분의 표준 동사는 제목 표시줄 또는 제목 표시줄 내의 드롭다운 동사 메뉴에 직접 표시됩니다. 이러한 동사가 헤더 또는 동사 메뉴에 직접 표시되는지 여부는 속성에 의해 WebPartVerbRenderMode 결정됩니다. 기본적으로 동사는 동사 메뉴에 표시됩니다. 다음 표에서는 다양한 Part 컨트롤과 연결된 공통 동사를 나열하고 해당 작업에 대해 설명합니다.

웹 파트 컨트롤 집합과 함께 제공되는 표준 동사와 함께 사용자 지정 동사를 만들 수도 있습니다. 사용자 지정 동사를 만드는 일반적인 시나리오는 컨트롤과 Part 연결된 동사를 만드는 것입니다. 이러한 동사를 만들 때 기본적으로 표준 동사와 함께 동사 메뉴에 표시됩니다. 이러한 동사를 만드는 기본 방법은 클래스에서 WebPartVerb 상속하여 하나 이상의 사용자 지정 동사를 만드는 것입니다. 그런 다음 기본 클래스에서 상속되는 컨트롤을 WebPart 만들고 컬렉션에 사용자 지정 WebPartVerb 개체를 WebPartVerbCollection 추가합니다. 그런 다음 이 컬렉션을 컨트롤의 컬렉션에 Verbs 추가할 수 있으므로 런타임에 사용자 지정 동사가 컨트롤의 동사 메뉴에 자동으로 표시됩니다. 표준 동사와 마찬가지로 컨트롤에서 프로그래밍 방식으로 사용자 지정 동사에 WebPart 액세스할 수 있습니다.

웹 파트 애플리케이션에서 상속 하지 않는 서버 컨트롤을 사용할 수는 WebPart ASP.NET 컨트롤, 사용자 지정 컨트롤 및 사용자 정의 컨트롤 등의 클래스입니다. 영역에 추가 WebPartZoneBase 된 경우 이러한 서버 컨트롤은 런타임에 개체로 GenericWebPart 동적으로 래핑되어 런타임 WebPart 컨트롤로 작동할 수 있습니다. 클래스에서 WebPart 상속되지 않는 서버 컨트롤에 사용자 지정 동사를 추가하려면 서버 컨트롤이 인터페이스를 구현하고 해당 Verbs 속성을 재정의 IWebActionable 해야 합니다.

동사를 만들 때 사용자가 동사를 클릭할 때 실행되는 두 가지 유형의 연결된 이벤트 처리기, 즉 서버 쪽 이벤트 처리기(서버에서 실행되는 코드) 및 클라이언트 쪽 이벤트 처리기(클라이언트 브라우저에서 실행되는 코드)를 만들 수 있습니다. 또한 동사에 대한 사용자 지정 상태를 정의할 수 있습니다. 이는 사용자에게 시각적 신호를 제공하는 유용한 방법입니다. 예를 들어 동사가 선택되었음을 나타내는 상태를 만든 다음 UI에서 적절한 변경 내용을 제공하여 동사가 이미 선택되었음을 사용자에게 알릴 수 있습니다. 다른 유용한 동작은; 동사를 사용 하지 않도록 설정 하는 기능 이 작업을 수행 하면 사용자는 것이 컴퓨터에 손상을 줄 또는 애플리케이션의 상태를 비효율적인 기반 하는 경우에 동사를 클릭 하 방지할 수 있습니다.

클래스는 WebPartVerb 고유한 메서드를 노출하지 않습니다. 노출된 메서드는 모두 기본 메서드의 재정의입니다. 그러나 개발자가 알아야 할 여러 속성이 포함되어 있습니다. 속성은 Checked 동사가 현재 선택되어 있는지 여부를 나타냅니다. 및 속성은 ClientClickHandler 클라이언트 및 ServerClickHandler 서버 클릭 이벤트에 대한 클래스 내의 각 처리기(있는 경우)를 참조합니다. 속성에는 Description 사용자가 UI의 동사 위에 마우스 포인터를 놓을 때 도구 설명에서 동사의 용도를 설명하는 텍스트가 포함되어 있습니다. 속성은 Enabled 동사의 현재 상태 나타내며 사용자가 동사를 클릭하고 해당 작업을 실행할 수 있는지 여부를 결정합니다. 속성은 ID 동사 개체에 대한 고유 ID를 제공합니다. 속성에는 ImageUrl 기본 렌더링(일반적으로 단추 또는 하이퍼링크) 대신 UI의 동사를 나타내는 데 사용할 수 있는 이미지에 대한 URL이 포함되어 있습니다. 속성에는 Text UI의 동사에 직접 표시되는 레이블 텍스트가 포함됩니다. 재정의된 Visible 속성은 동사가 현재 UI에 표시되는지 여부를 결정합니다. 동사는 종종 숨겨지거나; 웹 파트 애플리케이션에서 서로 다른 시간에 사용 하지 않도록 설정 예를 들어, 전문 동사 (예: 편집 동사와 연결 동사)는 의미 있는 작업을 수행 하도록 이러한 동사를 사용 하도록 설정 하려면 페이지의 적절 한 컨트롤, 설정 및 디스플레이 모드 존재 하는 경우에 표시 됩니다.

동사 작업을 위한 다른 주요 멤버로는 WebPartZoneBase.OnCreateVerbs 동사 만들기 프로세스의 사용자 지정 처리를 위해 재정의할 수 있는 이벤트 처리기인 메서드 및 WebPartZoneBase.CreateVerbs 이벤트가 있습니다.

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

• Verbs
• Verbs
• WebPartVerbCollection
• ASP.NET 웹 파트 컨트롤