WebPartManager 클래스

정의

public ref class WebPartManager : System::Web::UI::Control, System::Web::UI::INamingContainer, System::Web::UI::WebControls::WebParts::IPersonalizable

[System.ComponentModel.Bindable(false)]
public class WebPartManager : System.Web.UI.Control, System.Web.UI.INamingContainer, System.Web.UI.WebControls.WebParts.IPersonalizable

[<System.ComponentModel.Bindable(false)>]
type WebPartManager = class
    inherit Control
    interface INamingContainer
    interface IPersonalizable

Public Class WebPartManager
Inherits Control
Implements INamingContainer, IPersonalizable

상속

Object

Control

WebPartManager

특성

BindableAttribute

구현

INamingContainer IPersonalizable

예제

다음 코드 예제에서는 선언적 및 프로그래밍 방식으로 사용 하는 컨트롤입니다 WebPartManager .

코드 예제에는 네 부분으로 구성됩니다.

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

• 연결할 수 있는 두 개의 사용자 지정 WebPart 컨트롤과 <asp:webpartmanager> 요소가 포함된 웹 페이지입니다.

• 두 개의 사용자 지정 컨트롤과 사용자 지정 WebPart 인터페이스가 포함된 소스 코드 파일입니다.

• 예제가 브라우저에서 작동하는 방식에 대한 설명입니다.

사용자 컨트롤에는 페이지에 있는 웹 파트 컨트롤을 감안할 때 페이지에서 가능한 표시 모드를 보여 주는 드롭다운 목록 컨트롤이 있습니다. 이 코드 예제의 웹 페이지에서 이 사용자 컨트롤은 페이지 태그의 요소 바로 아래에 WebPartManager 선언되며 Register , 웹 페이지 맨 위에 컨트롤을 등록하는 지시문이 있습니다. 표시 모드 및 이 컨트롤의 소스 코드에 대한 설명에 대한 자세한 내용은 연습: 웹 파트 페이지에서 디스플레이 모드 변경을 참조하세요.

<%@ 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>

웹 페이지의 선언적 태그에는 사용자 정의 컨트롤과 사용자 지정 컨트롤 모두에 대한 지시문이 포함되어 Register 있습니다. <asp:webpartmanager> 요소, <asp:webpartzone> 사용자 지정 컨트롤을 포함할 요소 및 <asp:connectionszone> 요소가 있습니다. 페이지에는 컨트롤에 대한 WebPartManager 연결 관련 이벤트를 처리하는 일부 인라인 코드도 포함되어 있습니다. 컨트롤을 연결하고 연결을 끊을 때 이 코드의 효과를 볼 수 있습니다.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  private void UpdateLabelData(int wpCount, int connCount)
  {
    Label1.Text = "WebPart Control Count:  " + wpCount.ToString();
    Label2.Text = "Connections Count: " + connCount.ToString();
  }

  protected void WebPartManager1_WebPartsConnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }

  protected void WebPartManager1_WebPartsDisconnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }
  
</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">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
        OnWebPartsConnected="WebPartManager1_WebPartsConnected" 
        OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Protected Sub WebPartManager1_WebPartsConnected( _
    ByVal sender As Object, _
    ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
    
    UpdateLabelData(WebPartManager1.WebParts.Count, _
      WebPartManager1.Connections.Count)
    
  End Sub

  Protected Sub WebPartManager1_WebPartsDisconnected( _
    ByVal sender As Object, _
    ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
    
    UpdateLabelData(WebPartManager1.WebParts.Count, _
      WebPartManager1.Connections.Count)
    
  End Sub
  
  Private Sub UpdateLabelData(ByVal wpCount As Integer, _
    ByVal connCount As Integer)
    
    Label1.Text = "WebPart Control Count:  " & wpCount.ToString()
    Label2.Text = "Connections Count: " & connCount.ToString()
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server" OnWebPartsConnected="WebPartManager1_WebPartsConnected" OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuVB ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

예제의 세 번째 부분은 컨트롤의 소스 코드입니다. 라는 IZipCode인터페이스가 있으며 이 인터페이스는 클래스에서 ZipCodeWebPart 구현됩니다. 이 클래스에는 공급자 역할을 하는 라는 ProvideIZipCode 특수 콜백 메서드가 있습니다. 라는 WeatherWebPart다른 형식은 컨트롤이 다른 컨트롤의 소비자 역할을 할 수 있도록 하는 라는 GetIZipCode특수 메서드를 사용하여 구현됩니다.

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

namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (!string.IsNullOrEmpty(input.Text))
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }
    
    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }
  }
}

Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
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 Interface IZipCode

    Property ZipCode() As String

  End Interface

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZipCodeWebPart
    Inherits WebPart
    Implements IZipCode
    Private zipCodeText As String = String.Empty
    Private input As TextBox
    Private send As Button

    Public Sub New()
    End Sub

    ' Make the implemented property personalizable to save 
    ' the Zip Code between browser sessions.
    <Personalizable()> _
    Public Property ZipCode() As String _
      Implements IZipCode.ZipCode

      Get
        Return zipCodeText
      End Get
      Set(ByVal value As String)
        zipCodeText = value
      End Set
    End Property

    ' This is the callback method that returns the provider.
    <ConnectionProvider("Zip Code")> _
    Public Function ProvideIZipCode() As IZipCode
      Return Me
    End Function


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      input = New TextBox()
      Me.Controls.Add(input)
      send = New Button()
      send.Text = "Enter 5-digit Zip Code"
      AddHandler send.Click, AddressOf Me.submit_Click
      Me.Controls.Add(send)

    End Sub


    Private Sub submit_Click(ByVal sender As Object, _
      ByVal e As EventArgs)

      If input.Text <> String.Empty Then
        zipCodeText = Page.Server.HtmlEncode(input.Text)
        input.Text = String.Empty
      End If

    End Sub

  End Class

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class WeatherWebPart
    Inherits WebPart
    Private _provider As IZipCode
    Private _zipSearch As String
    Private DisplayContent As Label

    ' This method is identified by the ConnectionConsumer 
    ' attribute, and is the mechanism for connecting with 
    ' the provider. 
    <ConnectionConsumer("Zip Code")> _
    Public Sub GetIZipCode(ByVal Provider As IZipCode)
      _provider = Provider
    End Sub


    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
      EnsureChildControls()

      If Not (Me._provider Is Nothing) Then
        _zipSearch = _provider.ZipCode.Trim()
    DisplayContent.Text = "My Zip Code is:  " + _zipSearch
      End If

    End Sub

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      Me.Controls.Add(DisplayContent)

    End Sub

  End Class

End Namespace

브라우저에서 웹 페이지를 로드한 후 표시 모드 드롭다운 목록 컨트롤을 클릭하고 연결을 선택하여 페이지를 연결 모드로 전환합니다. 연결 모드는 <asp:connectionszone> 요소를 사용하여 컨트롤 간에 연결을 만들 수 있도록 합니다. 연결 모드에서 우편 번호 컨트롤의 제목 표시줄에서 아래쪽 화살표를 클릭하여 동사 메뉴를 활성화한 다음 연결을 클릭합니다. 연결 UI가 나타나면 소비자에 대한 연결 만들기 링크를 클릭합니다. 드롭다운 목록 컨트롤이 있는 셀이 나타납니다. 드롭다운 목록에서 날씨 제어 를 선택한 다음 연결을 클릭하여 두 컨트롤의 연결을 완료합니다. 닫기를 클릭한 다음 표시 모드 드롭다운 목록을 사용하여 페이지를 일반 찾아보기 모드로 반환합니다. 우편 번호를 입력하면 소비자 컨트롤이 입력한 값으로 업데이트됩니다. 속성이 ZipCode 소스 코드의 Personalizable 특성으로 표시되었으므로 이 속성 값은 브라우저 세션에서 유지되므로 사용자가 입력한 값을 저장합니다. 보다 정교한 소비자 제어는 우편 번호 정보를 가져와서 코드를 기반으로 날씨 정보를 조회하고 사용자에게 표시할 수 있습니다.

설명

WebPartManager 허브 또는 제어 센터 웹 파트 애플리케이션의 역할입니다. 웹 파트 컨트롤을 사용하는 모든 페이지에는 컨트롤 instance 하나WebPartManager만 있어야 합니다. 웹 파트 애플리케이션의 대부분의 측면에서와 마찬가지로 WebPartManager 컨트롤의 인증 된 사용자만 작동 합니다. 또한 해당 기능은 거의 전적으로 클래스에서 상속되는 웹 파트 영역 내에 있는 서버 컨트롤에서 WebZone 작동합니다. 이러한 영역 외부의 페이지에 있는 서버 컨트롤에는 웹 파트 기능이나 컨트롤과의 상호 작용이 WebPartManager 거의 없습니다.

페이지의 웹 파트 기능 허브인 컨트롤은 WebPartManager 다음 표에 설명된 작업의 종류를 수행합니다.

클래스에는 WebPartManager 많은 속성 집합이 있습니다. 다른 컨트롤을 WebPartManager 추적하는 역할과 일치하면 웹 파트 컨트롤 또는 기타 특수 웹 파트 개체의 컬렉션을 참조하는 여러 속성이 있습니다. AvailableTransformers, , Connections, Controls, DisplayModes, DynamicConnections, SupportedDisplayModes, WebParts및 Zones 속성은 컨트롤이 WebPartManager 추적 및 기타 관리 작업에 사용하는 모든 컬렉션입니다.

속성의 다른 그룹은 웹 파트 애플리케이션에서 발생 하는 특정 시나리오에 적용 되는 사용자 지정 가능한 경고를 포함 합니다. 여기에는 , DeleteWarning및 속성이 포함CloseProviderWarning됩니다ExportSensitiveDataWarning.

클래스는 WebPartManager 여러 웹 서버 컨트롤에서 사용하는 기본 상속 속성 중 일부를 재정의합니다. 여기에는 , SkinID및 Visible 속성이 EnableTheming포함됩니다.

마지막으로, 반드시 속성 그룹을 애플리케이션의 현재 상태에 액세스 하는 데 유용 합니다. 속성은 DisplayMode 페이지가 있는 현재 표시 모드를 나타냅니다. 속성은 EnableClientScript 컨트롤이 클라이언트 쪽 스크립트를 렌더링할 수 있는지 여부를 나타냅니다. 이 스크립트는 사용자가 다른 기능을 가진 브라우저를 사용하거나 스크립팅이 꺼져 있을 수 있는 상황과 관련이 있습니다. Internals 속성 확장성 사례에 사용 되는 중요 한 웹 파트 메서드의 숫자에 대 한 호출을 포함 하는 유틸리티 클래스를 참조 하는 데 유용 합니다. 별도의 클래스(클래스)WebPartManager에서 이러한 메서드에 대한 호출을 WebPartManagerInternals 숨기면 클래스의 자체 API가 간소화됩니다. Personalization 속성은 사용자의 개인 설정을 저장하고 영구 스토리지에 해당 데이터를 유지하는 개인 설정 개체에 대한 액세스를 제공합니다. 합니다 SelectedWebPart 속성을 나타내는 WebPart 사용자 또는 애플리케이션 페이지에서 컨트롤의 현재 선택 되어 있습니다. 속성은 IPersonalizable.IsDirty 컨트롤의 WebPart 사용자 지정 개인 설정 데이터가 변경되었는지 여부를 나타냅니다.

컨트롤에는 WebPartManager 5개의 기본 제공 디스플레이 모드 또는 웹 페이지의 보기가 포함되어 있습니다. 개발자는 클래스 또는 클래스와 같은 형식을 확장하여 사용자 지정 표시 모드를 만들어 이 기능을 확장할 WebZoneToolZone 수 있습니다. 지정된 디스플레이 모드에 해당하는 적절한 종류의 컨트롤이 페이지에 있는 경우 사용자는 페이지를 다양한 디스플레이 모드로 전환할 수 있습니다.

표준 표시 모드는 클래스의 공용 필드로 WebPartManager 표시됩니다. 다음 표에는 필드와 필드가 참조하는 표시 모드가 요약되어 있습니다. 위에서 설명한 대로 페이지의 현재 표시 모드는 항상 속성에서 DisplayMode 참조되며, 페이지에 있는 영역의 종류를 고려할 때 특정 페이지에서 가능한 표시 모드 집합이 속성에 포함됩니다 SupportedDisplayModes .

또한 컨트롤에는 WebPartManager 웹 파트 페이지 및 컨트롤의 수명 주기에 중요한 여러 이벤트가 포함되어 있습니다. 이러한 이벤트는 웹 파트 컨트롤의 동작에 대한 정확한 프로그래밍 방식 제어를 제공합니다. 대부분의 메서드는 컨트롤(또는 컨트롤로 WebPart 동작할 WebPart 수 있도록 영역에 배치 WebPartZoneBase 된 다른 서버 또는 사용자 컨트롤)과 직접 관련됩니다. 그러나 페이지의 상태 또는 페이지의 연결과 관련된 몇 가지 이벤트가 있습니다. 다음 표에서는 사용 가능한 이벤트를 나열하고 해당 용도를 요약합니다.

WebPartManager 컨트롤에는 웹 파트 페이지를 관리하는 다양한 메서드가 있습니다. 여기에 나열되지 않은 많은 메서드 집합은 이름이 OnEventName 형식인 메서드입니다. 이러한 메서드는 일반적으로 연결된 이벤트를 발생시키고 형식의 WebPartEventHandler처리기를 사용하여 이벤트를 제공합니다. 이러한 메서드의 대부분은 클래스에서 상속하는 개발자가 재정의 WebPartManager 할 수 있습니다. 또한 페이지 개발자는 이러한 메서드와 연결된 이벤트에 대한 사용자 지정 처리기를 제공할 수 있습니다. 예를 들어 이벤트의 경우 WebPartAdded 페이지 개발자는 웹 페이지 태그의 요소에 특성을 <asp:webpartmanager> 추가 OnWebPartAdded 한 다음 사용자 지정 메서드 이름을 특성에 할당하여 이벤트에 대한 사용자 지정 처리를 제공할 수 있습니다. 특성은 메서드에 OnWebPartAdded 해당하며 이 기본 이벤트 처리 패턴은 대부분의 웹 파트 이벤트 및 관련 메서드에서 작동합니다.

또한 컨트롤에는 WebPartManager 컨트롤 관리 WebPart 작업(및 컨트롤로 WebPart 사용되는 서버 또는 사용자 컨트롤)과 관련된 메서드가 있습니다. 이러한 메서드에는 , , AuthorizeWebPart, CloseWebPart, CreateWebPartCopyWebPart, DeleteWebPart, DisconnectWebPart, BeginWebPartEditing, EndWebPartEditing, ExportWebPart, GetGenericWebPart, ImportWebPart, , IsAuthorized및 가 포함AddWebPart됩니다MoveWebPart.

다른 메서드 집합은 연결을 위해 특수화되어 있습니다. 여기에는 , , , BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, DisconnectWebPartsGetConsumerConnectionPointsCreateAvailableTransformersDisconnectWebPartEndWebPartConnecting및 와 같은 ActivateConnections메서드가 포함됩니다.GetProviderConnectionPoints

마지막으로, 일부 WebPartManager 방법은 개인 설정 기능에 중점을 줍니다. 여기에는 CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save 및 SaveControlState이 포함됩니다.

속성을 통해 액세스할 수 있는 다른 WebPartManager 메서드에 Internals 대한 자세한 내용은 클래스에 대한 WebPartManagerInternals 설명서를 참조하세요.

상속자 참고

컨트롤은 WebPartManager 확장되도록 설계되었습니다. 중앙 웹 파트 애플리케이션에 일부 특정 형식을 확장 하거나, 대부분의 웹 파트 컨트롤 집합에서 제어 하려는 경우에 확장 되어야 하므로 이므로 WebPartManager 클래스, 속성 또는 메서드를 확인 하는 데 필요한 몇 가지 가능성이 있기 때문에 사용자 지정 형식의 웹 파트 애플리케이션의 컨텍스트에서 작동 합니다. 웹 파트 참조 설명서(참조 System.Web.UI.WebControls.WebParts)는 웹 파트 형식을 확장하는 방법을 논의할 때 클래스를 확장 WebPartManager 하기 위해 수행해야 하는 작업을 자주 언급하거나 코드 예제에서 확장하는 방법을 보여 줍니다.

생성자

필드

속성

메서드

이벤트

명시적 인터페이스 구현

확장 메서드

적용 대상

추가 정보

• WebPartManagerInternals
• ASP.NET 웹 파트 컨트롤