WebPartManager クラス

リファレンス

定義

名前空間:: System.Web.UI.WebControls.WebParts

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Web パーツのコントロール、機能、および Web ページ上で発生するイベントのすべてを管理する、Web パーツコントロールセットの中心的なクラスとして機能します。

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 示します。

このコード例には、次の 4 つの部分があります。

Web パーツページの表示モードを変更できるユーザーコントロール。
接続できる 2 つのカスタム WebPart コントロールと <asp:webpartmanager> 要素を含む Web ページ。
2 つのカスタムコントロールとカスタム WebPart インターフェイスを含むソースコードファイル。
ブラウザーでのこの例の動作の説明。

ユーザーコントロールには、ページ上に存在する Web パーツコントロールに基づいて、ページで使用可能な表示モードを示すドロップダウンリストコントロールがあります。このコード例の Web ページでは、このユーザーコントロールはページのマークアップの要素のすぐ下 WebPartManager に宣言されており、Web ページの上部付近にコントロールを登録するためのディレクティブがあります Register 。このコントロールの表示モードとソースコードの説明の詳細については、「チュートリアル: Web パーツページでの表示モードの変更」を参照してください。

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

Web ページの宣言型マークアップには、 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>

この例の 3 番目の部分は、コントロールのソースコードです。という名前 IZipCodeのインターフェイスがあり、このインターフェイスはクラスに実装されていることに ZipCodeWebPart 注意してください。このクラスには、プロバイダーとして機能するという名前 ProvideIZipCode の特別なコールバックメソッドがあります。という名前 WeatherWebPartのもう 1 つの型も、という特殊 GetIZipCodeなメソッドを使用して実装されます。これにより、コントロールが他のコントロールのコンシューマーとして機能できるようになります。

コード例を実行するには、このソースコードをコンパイルする必要があります。明示的にコンパイルし、結果のアセンブリを Web サイトの Bin フォルダーまたはグローバルアセンブリキャッシュに配置できます。または、ソースコードをサイトの App_Code フォルダーに配置して、実行時に動的にコンパイルすることもできます。このコード例では、ソースをアセンブリにコンパイルし、Web ページのディレクティブが Register アセンブリ名を参照していることを前提としています。コンパイル方法を示すチュートリアルについては、「チュートリアル: カスタム Web サーバーコントロールの開発と使用」を参照してください。

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

ブラウザーに Web ページを読み込んだ後、[ 表示モード ] ドロップダウンリストコントロールをクリックし、[ 接続 ] を選択してページを接続モードに切り替えます。接続モードでは、要素を <asp:connectionszone> 使用して、コントロール間の接続を作成できます。接続モードで、 ZIP コード コントロールのタイトルバーにある下向き矢印をクリックして動詞メニューをアクティブにし、[ 接続] をクリックします。接続 UI が表示されたら、[ コンシューマーへの接続を作成 する] リンクをクリックします。ドロップダウンリストコントロールがあるセルが表示されます。ドロップダウンリストで [ Weather Control ] を選択し、[ 接続 ] をクリックして 2 つのコントロールの接続を完了します。 [ 閉じる] をクリックし、[ 表示モード ] ドロップダウンリストを使用して、ページを通常のブラウズモードに戻します。郵便番号を入力すると、入力した値でコンシューマーコントロールが更新されます。プロパティは ZipCode ソースコードの属性で Personalizable マークされているため、このプロパティ値はブラウザーセッション間で保持されるため、ユーザーが入力した値を保存します。より高度なコンシューマーコントロールでは、郵便番号情報を取得し、コードに基づいて気象情報を検索し、ユーザーに表示することができます。

注釈

コントロールは WebPartManager 、Web パーツアプリケーションのハブまたはコントロールセンターとして機能します。 Web パーツコントロールを使用するすべてのページには、1 つだけWebPartManager のコントロールインスタンスが必要です。 Web パーツアプリケーションのほとんどの側面と同様に、コントロールは WebPartManager 認証されたユーザーでのみ機能します。さらに、その機能は、クラスから継承する Web パーツゾーン内に存在するサーバーコントロールとほぼ完全に WebZone 機能します。これらのゾーンの外部のページに存在するサーバーコントロールには、Web パーツの機能やコントロールとの相互作用がほとんど WebPartManager ない場合があります。

コントロールは、ページ上の Web パーツ機能のハブとして、 WebPartManager 次の表で説明するタスクの種類を実行します。

タスクのカテゴリ	コントロールの動作
Web パーツコントロールの追跡	コントロール、接続、ゾーンなど WebPart 、Web パーツ機能を提供するページ上のさまざまな種類のコントロールを追跡します。
Web パーツコントロールの追加と削除	ページ上のコントロールを追加、削除、終了 WebPart するためのメソッドを提供します。
接続の管理	コントロール間の接続を作成し、接続と、それらを追加および削除するプロセスを監視します。
コントロールとページのカスタマイズ	ユーザーがコントロールをページ上の別の場所に移動し、コントロールの外観、プロパティ、および動作を編集できるビューを起動できるようにします。各ページでユーザー固有の個人用設定を維持します。
異なるページビュー間の切り替え	ユーザーがページレイアウトの変更やコントロールの編集などの特定のタスクを実行できるように、ページのさまざまな特殊なビュー間でページを切り替えます。
Web パーツのライフサイクルイベントの発生	コントロールの追加、移動、接続、削除などの Web パーツコントロールのライフサイクルイベントを開発者が定義、発生、および処理できるようにします。
コントロールのインポートとエクスポートを有効にする	コントロールのプロパティの状態を含む XML ストリームをエクスポートし、ユーザーが他の WebPart ページまたはサイトで複雑なコントロールをカスタマイズする際に便利なファイルをインポートできるようにします。

WebPartManagerクラスには、プロパティの大きなセットがあります。他のコントロールを追跡する WebPartManager 役割と一致し、Web パーツコントロールまたはその他の特殊な Web パーツオブジェクトのコレクションを参照するプロパティが多数用意されています。、AvailableTransformers、Connections Controls、DisplayModes、DynamicConnections、SupportedDisplayModes WebParts、および Zones の各プロパティは、コントロールが追跡やその他のWebPartManager管理タスクに使用するすべてのコレクションです。

プロパティの別のグループには、Web パーツアプリケーションで発生する特定のシナリオに適用されるカスタマイズ可能な警告が含まれています。これには、、 CloseProviderWarning、 DeleteWarningおよびプロパティが ExportSensitiveDataWarning 含まれます。

クラスは WebPartManager 、多くの Web サーバーコントロールで使用される基本継承プロパティの一部をオーバーライドします。これには、EnableTheming SkinIDおよびの各プロパティがVisible含まれます。

最後に、アプリケーションの現在の状態にアクセスするのに役立つプロパティのグループがあります。プロパティは DisplayMode 、ページが存在する現在の表示モードを示します。プロパティは EnableClientScript 、コントロールがクライアント側スクリプトのレンダリングを許可されているかどうかを示します。これは、ユーザーが異なる機能を持つブラウザーを持っているか、スクリプトをオフにしている可能性がある状況に関連します。プロパティは Internals 、拡張ケースに使用される多数の重要な Web パーツメソッドの呼び出しを含むユーティリティクラスを参照する場合に便利です。これらのメソッドの呼び出しを別のクラス ( WebPartManagerInternals クラス) で非表示にすると、 WebPartManager クラス独自の API が簡略化されます。プロパティは Personalization 、ユーザーの個人用設定を格納し、そのデータを永続的なストレージに保持するパーソナル化オブジェクトへのアクセスを提供します。プロパティは SelectedWebPart 、 WebPart ユーザーまたはアプリケーションによって現在選択されているページ上のコントロールを示します。プロパティは IPersonalizable.IsDirty 、コントロールのカスタムパーソナル化データ WebPart が変更されたかどうかを示します。

コントロールには WebPartManager 、5 つの組み込みの表示モード、または Web ページのビューが含まれています。開発者はこの機能を拡張し、クラスやクラスなどの型を拡張することでカスタム表示モードをWebZone ToolZone作成できます。特定の表示モードに対応する適切な種類のコントロールがページ上に存在する場合、ユーザーはページをさまざまな表示モードに切り替えることができます。

注意

この機能を拡張して、ユーザーがページ上に対応するゾーンを持たずにカスタム表示モードに切り替えることができます。ただし、既定の動作では、表示モードはゾーンに対応します。

標準の表示モードは、クラスのパブリックフィールドで WebPartManager 表されます。次の表は、フィールドとそれらが参照する表示モードをまとめたものです。上で説明したように、ページの現在の表示モードは常にプロパティで DisplayMode 参照され、ページに存在するゾーンの種類を指定すると、特定のページで可能な表示モードのセットがプロパティに SupportedDisplayModes 含まれます。

フィールド	表示モードの詳細
BrowseDisplayMode	Web ページの通常のユーザービュー。既定および最も一般的な表示モード。
DesignDisplayMode	ユーザーがコントロールを再配置または削除してページレイアウトを変更できるビュー。
EditDisplayMode	編集ユーザーインターフェイス (UI) が表示されるビュー。ユーザーは、通常のブラウズモードで表示されるコントロールの外観、プロパティ、および動作を編集できます。
CatalogDisplayMode	カタログ UI が表示されるビュー。ユーザーは、使用可能なコントロールのカタログからページにコントロールを追加できます。
ConnectDisplayMode	接続 UI が表示されるビュー。ユーザーは、コントロール間の接続を接続、管理、または切断できます。

WebPartManagerコントロールには、Web パーツページとコントロールのライフサイクルで重要なイベントも多数含まれています。これらのイベントを使用すると、Web パーツコントロールの動作をプログラムで正確に制御できます。ほとんどのメソッドは、コントロール (またはコントロールとしてWebPart動作できるようにゾーンに配置された他のWebPartZoneBaseサーバーまたはユーザーコントロール) に直接WebPart関係します。ただし、いくつかのイベントは、ページまたはページ上の接続の状態に関連します。次の表は、使用可能なイベントの一覧とその目的をまとめたものです。

注意

次の表のすべての場合において、"control" という単語は、ゾーン内に存在し、実行時に WebPart オブジェクトでラップされたコントロールまたはサーバーコントロールを GenericWebPart 参照します。

Event	説明
AuthorizeWebPart	コントロールが承認されていることを確認するために、ページに追加される直前に発生します。
ConnectionsActivated	ページ上のすべての接続がアクティブ化された後に発生します。
ConnectionsActivating	ページ上のすべての接続をアクティブ化するプロセスの直前に発生します。
DisplayModeChanged	ページの現在の表示モードが変更された後に発生します。
DisplayModeChanging	ページの表示モードを変更するプロセスの直前に発生します。
SelectedWebPartChanged	コントロールの選択が取り消された後に発生します。
SelectedWebPartChanging	コントロールの選択を取り消すプロセスの直前に発生します。
WebPartAdded	コントロールがゾーンに追加された後に発生します。
WebPartAdding	コントロールをゾーンに追加するプロセスの直前に発生します。
WebPartClosed	コントロールが閉じられた (ページから削除された) 後に発生します。
WebPartClosing	コントロールを閉じるプロセスの直前に発生します。
WebPartDeleted	動的コントロールのインスタンス (プログラムによって作成されたもの、またはカタログから追加されたもの) が完全に削除された後に発生します。
WebPartDeleting	動的コントロールを削除するプロセスの直前に発生します。
WebPartMoved	コントロールがゾーン内または別のゾーンに移動した後に発生します。
WebPartMoving	コントロールを移動するプロセスの直前に発生します。
WebPartsConnected	接続に参加するために選択された 2 つのコントロールが接続を確立した後に発生します。
WebPartsConnecting	2 つのコントロールを接続するプロセスの直前に発生します。
WebPartsDisconnected	2 つの接続されたコントロールが切断された後に発生します。
WebPartsDisconnecting	2 つのコントロールを切断するプロセスの直前に発生します。

WebPartManagerコントロールには、Web パーツページを管理するためのさまざまな方法があります。ここに記載されていないメソッドの大きなセットは、名前が OnEventName の形式のメソッドです。これらのメソッドは通常、関連するイベントを発生させ、型のハンドラーをイベントに提供します WebPartEventHandler。これらのメソッドのほとんどは、クラスから WebPartManager 継承する開発者によってオーバーライドできます。また、ページ開発者は、これらのメソッドに関連付けられているイベントのカスタムハンドラーを提供できます。たとえば、イベントの場合、ページ開発者は Web ページのWebPartAddedマークアップの要素に<asp:webpartmanager>属性を追加OnWebPartAddedし、その属性にカスタムメソッド名を割り当てて、イベントのカスタム処理を提供できます。属性はメソッドに OnWebPartAdded 対応しており、このイベント処理の基本的なパターンは、ほとんどの Web パーツイベントとそれに関連するメソッドに対して機能します。

さらに、コントロールには、WebPartManagerコントロール (およびコントロールとしてWebPart使用されるサーバーまたはユーザーコントロール) を管理するWebPartタスクに特有のメソッドがあります。これらのメソッドには、、AuthorizeWebPart、、CloseWebPart、CopyWebPart、、CreateWebPart、、DeleteWebPart、DisconnectWebPart、 GetGenericWebPart IsAuthorized ImportWebPart BeginWebPartEditing EndWebPartEditing ExportWebPartが含まれます。MoveWebPart AddWebPart

別の一連のメソッドは、接続に特化しています。これには、、、、、、 DisconnectWebParts CreateAvailableTransformers EndWebPartConnecting ConnectWebParts GetConsumerConnectionPoints DisconnectWebPartなどのActivateConnectionsメソッドが含まれます。GetProviderConnectionPoints CanConnectWebParts BeginWebPartConnecting

最後に、一部 WebPartManager の方法ではパーソナル化機能に重点を置きます。これらのメソッドには、CreatePersonalization、LoadControlState、SaveCustomPersonalizationState、SetPersonalizationDirty、IPersonalizable.Load、IPersonalizable.Save、および SaveControlState が含まれます。

プロパティからアクセスInternalsできる他WebPartManagerのメソッドの詳細については、クラスのドキュメントをWebPartManagerInternals参照してください。

注意 (継承者)

コントロールは WebPartManager 拡張するように設計されています。これは Web パーツアプリケーションの中心であるため、Web パーツコントロールセットで特定の型またはコントロールを拡張する場合は、多くの場合、クラスも拡張 WebPartManager する必要があります。これは、カスタム型を Web パーツアプリケーションのコンテキストで動作させるために必要なプロパティまたはメソッドが存在する可能性が高いためです。 Web パーツの参照ドキュメント (参照 System.Web.UI.WebControls.WebParts) では、Web パーツの種類を拡張する方法について説明するとき、クラスを拡張 WebPartManager するために必要な操作について頻繁に説明したり、コード例でそれを拡張する方法を示したりします。

コンストラクター

WebPartManager()

WebPartManager クラスの新しいインスタンスを初期化します。

フィールド

BrowseDisplayMode	Web パーツコントロールが含まれたページの既定の表示モードを表します。このフィールドは読み取り専用です。
CatalogDisplayMode	コントロールのカタログから Web ページにサーバーコントロールを追加する場合に使用する表示モードを表します。このフィールドは読み取り専用です。
ConnectDisplayMode	ユーザーが WebPart コントロール間の接続を管理するための特殊なユーザーインターフェイス (UI) を表示する場合に使用する表示モードを表します。このフィールドは読み取り専用です。
DesignDisplayMode	Web パーツコントロールを含む Web ページのレイアウトを変更する場合に使用する表示モードを表します。このフィールドは読み取り専用です。
EditDisplayMode	エンドユーザーによるサーバーコントロールの編集および変更が可能な表示モードを表します。このフィールドは読み取り専用です。

プロパティ

Adapter	コントロール用のブラウザー固有のアダプターを取得します。 (継承元 Control)
AppRelativeTemplateSourceDirectory	このコントロールが含まれている Page オブジェクトまたは UserControl オブジェクトのアプリケーション相対の仮想ディレクトリを取得または設定します。 (継承元 Control)
AvailableTransformers	サーバーコントロールの間に Web パーツ接続を作成する場合に使用できる WebPartTransformer オブジェクトのコレクションを取得します。
BindingContainer	このコントロールのデータバインディングを格納しているコントロールを取得します。 (継承元 Control)
ChildControlsCreated	サーバーコントロールの子コントロールが作成されたかどうかを示す値を取得します。 (継承元 Control)
ClientID	ASP.NET によって生成される HTML マークアップのコントロール ID を取得します。 (継承元 Control)
ClientIDMode	ClientID プロパティの値を生成するために使用されるアルゴリズムを取得または設定します。 (継承元 Control)
ClientIDSeparator	ClientID プロパティで使用される区切り記号を表す文字値を取得します。 (継承元 Control)
CloseProviderWarning	接続で他のコントロールに対するプロバイダーとして動作しているコントロールをユーザーが終了すると表示される警告を取得または設定します。
Connections	Web ページ上の現在の接続すべてのコレクションへの参照を取得します。
Context	現在の Web 要求に対するサーバーコントロールに関連付けられている HttpContext オブジェクトを取得します。 (継承元 Control)
Controls	Web ページ上の WebPart ゾーン内にあり、WebPartZoneBase コントロールによって管理される、すべての WebPartManager コントロール、サーバーコントロール、またはユーザーコントロールのコレクションを取得します。
DataItemContainer	名前付けコンテナーが IDataItemContainer を実装している場合、名前付けコンテナーへの参照を取得します。 (継承元 Control)
DataKeysContainer	名前付けコンテナーが IDataKeysControl を実装している場合、名前付けコンテナーへの参照を取得します。 (継承元 Control)
DeleteWarning	エンドユーザーがコントロールを削除したときにそのユーザーに対して表示するカスタム警告メッセージを取得または設定します。
DesignMode	コントロールがデザインサーフェイスで使用されているかどうかを示す値を取得します。 (継承元 Control)
DisplayMode	Web パーツコントロールが含まれた Web ページのアクティブな表示モードを取得または設定します。
DisplayModes	WebPartManager コントロールに関連付けられたすべての表示モードの読み取り専用のコレクションを取得します。
DynamicConnections	現在 Web ページ上に存在するすべての動的接続のコレクションを取得します。
EnableClientScript	WebPartManager コントロールが含まれた Web ページ上でクライアント側スクリプト機能を有効にするかどうかを決定する値を取得または設定します。
EnableTheming	Web ページ上でテーマを使用できることを示す値を取得します。
EnableViewState	要求元クライアントに対して、サーバーコントロールがそのビュー状態と、そこに含まれる任意の子のコントロールのビュー状態を保持するかどうかを示す値を取得または設定します。 (継承元 Control)
Events	コントロールのイベントハンドラーデリゲートのリストを取得します。このプロパティは読み取り専用です。 (継承元 Control)
ExportSensitiveDataWarning	ユーザーが WebPart コントロールから重要な状態情報をエクスポートしようとしたときに表示される警告メッセージのテキストを取得または設定します。
HasChildViewState	現在のサーバーコントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。 (継承元 Control)
ID	サーバーコントロールに割り当てられたプログラム ID を取得または設定します。 (継承元 Control)
IdSeparator	コントロール ID を区別するために使用する文字を取得します。 (継承元 Control)
Internals	実際には WebPartManagerInternals クラスに実装されていても、ほとんどの場合コントロールの開発者に役立つメソッドのセットを構成したり分割したりするために使用する、WebPartManager クラスへの参照を取得します。
IsChildControlStateCleared	このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。 (継承元 Control)
IsCustomPersonalizationStateDirty	WebPartManager コントロールにより制御されるページレベルのパーソナル化の情報に影響を与えるような、パーソナル化に関する変更が行われたかどうかを示す値を取得します。
IsTrackingViewState	サーバーコントロールがビューステートの変更を保存しているかどうかを示す値を取得します。 (継承元 Control)
IsViewStateEnabled	このコントロールでビューステートが有効かどうかを示す値を取得します。 (継承元 Control)
LoadViewStateByID	コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。 (継承元 Control)
MediumPermissionSet	PermissionSet および Execution のアクセス許可のみを付与する Medium オブジェクトを取得します。
MinimalPermissionSet	PermissionSet および Execution のアクセス許可のみを付与する Minimal オブジェクトを取得します。
NamingContainer	同じ ID プロパティ値を持つ複数のサーバーコントロールを区別するための一意の名前空間を作成する、サーバーコントロールの名前付けコンテナーへの参照を取得します。 (継承元 Control)
Page	サーバーコントロールを含んでいる Page インスタンスへの参照を取得します。 (継承元 Control)
Parent	ページコントロールの階層構造における、サーバーコントロールの親コントロールへの参照を取得します。 (継承元 Control)
Personalization	Web ページのパーソナル化データが格納されたオブジェクトへの参照を取得します。
RenderingCompatibility	レンダリングされる HTML と互換性がある ASP.NET のバージョンを表す値を取得します。 (継承元 Control)
SelectedWebPart	別のコントロールとの接続を編集または作成するために現在選択されている WebPart コントロールまたはその他のサーバーコントロールへの参照を取得します。
Site	デザインサーフェイスに現在のコントロールを表示するときに、このコントロールをホストするコンテナーに関する情報を取得します。 (継承元 Control)
SkinID	WebPartManager コントロールにスキンを適用できないように、空の文字列 ("") を取得または設定します。
StaticConnections	Web ページ上の静的接続として定義されているすべての WebPartConnection オブジェクトのコレクションへの参照を取得します。
SupportedDisplayModes	特定の Web ページ上で使用できるすべての表示モードの読み取り専用のコレクションを取得します。
TemplateControl	このコントロールを格納しているテンプレートへの参照を取得または設定します。 (継承元 Control)
TemplateSourceDirectory	現在のサーバーコントロールを格納している Page または UserControl の仮想ディレクトリを取得します。 (継承元 Control)
UniqueID	階層構造で修飾されたサーバーコントロールの一意の ID を取得します。 (継承元 Control)
ValidateRequestMode	ブラウザーからのクライアント入力の安全性をコントロールで調べるかどうかを示す値を取得または設定します。 (継承元 Control)
ViewState	同一のページに対する複数の要求にわたって、サーバーコントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 (継承元 Control)
ViewStateIgnoresCase	StateBag オブジェクトが大文字小文字を区別しないかどうかを示す値を取得します。 (継承元 Control)
ViewStateMode	このコントロールのビューステートモードを取得または設定します。 (継承元 Control)
Visible	子コントロールを表示できるようにする値を取得します。
WebParts	Web ページ上の WebPart コントロールで追跡されるすべての WebPartManager コントロールへの参照を取得します。
Zones	Web ページ上のすべての WebPartZoneBase ゾーンのコレクションへの参照を取得します。

メソッド

ActivateConnections()	Web ページ上で現在アクティブでないすべての接続をアクティブにします。
AddedControl(Control, Int32)	子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。 (継承元 Control)
AddParsedSubObject(Object)	XML または HTML のいずれかの要素が解析されたことをサーバーコントロールに通知し、サーバーコントロールの ControlCollection オブジェクトに要素を追加します。 (継承元 Control)
AddWebPart(WebPart, WebPartZoneBase, Int32)	Web ページにプログラムで WebPart コントロールを追加する標準メソッドを提供します。
ApplyStyleSheetSkin(Page)	ページのスタイルシートに定義されたスタイルプロパティをコントロールに適用します。 (継承元 Control)
BeginRenderTracing(TextWriter, Object)	レンダリングデータのデザイン時のトレースを開始します。 (継承元 Control)
BeginWebPartConnecting(WebPart)	2 つの WebPart コントロールを接続するプロセスを開始します。
BeginWebPartEditing(WebPart)	WebPart コントロールを編集するプロセスを開始します。
BuildProfileTree(String, Boolean)	ページのトレースが有効な場合、サーバーコントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。 (継承元 Control)
CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)	コンシューマーコントロールとプロバイダーコントロールが互換性のあるインターフェイスを持ち、WebPart オブジェクトが不要な場合に、接続に関係する WebPartTransformer コントロールをチェックし、こうしたコントロールを接続できるかどうかを判断します。
CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)	接続に関係する WebPart コントロールをチェックして、こうしたコントロールが接続可能かどうかを判断し、WebPartTransformer オブジェクトを使用して互換性のないコンシューマーとプロバイダーの間に接続を作成します。
CheckRenderClientScript()	ブラウザーから要求を行う機能および EnableClientScript プロパティの値をチェックし、クライアントスクリプトを表示するかどうかを判断します。
ClearCachedClientID()	キャッシュされた ClientID 値を `null` に設定します。 (継承元 Control)
ClearChildControlState()	サーバーコントロールのすべての子コントロールについて、コントロールの状態情報を削除します。 (継承元 Control)
ClearChildState()	サーバーコントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。 (継承元 Control)
ClearChildViewState()	サーバーコントロールのすべての子コントロールのビューステート情報を削除します。 (継承元 Control)
ClearEffectiveClientIDMode()	現在のコントロールインスタンスおよびすべての子コントロールの ClientIDMode プロパティを Inherit に設定します。 (継承元 Control)
CloseWebPart(WebPart)	Web ページ上に表示されなくても再度開くことができる方法で WebPart コントロールを終了します。
ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)	コントロールへの参照とその指定された WebPart オブジェクトだけを使用して、2 つの GenericWebPart コントロールまたは ConnectionPoint コントロールの間に接続を作成します。
ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)	コントロールへの参照、指定された WebPart オブジェクト、および GenericWebPart オブジェクトを使用して、2 つの ConnectionPoint コントロールまたは WebPartTransformer コントロール間の接続を作成します。
CopyWebPart(WebPart)	Web ページに WebPart コントロールまたはサーバーコントロールを追加するためにこうしたコントロールのコピーを作成する場合に、Web パーツコントロールセットで使用されます。
CreateAvailableTransformers()	Web サイトの構成ファイルに指定されているトランスフォーマーのセットを作成し、AvailableTransformers プロパティで参照されるトランスフォーマーのコレクションにそれを追加します。
CreateChildControls()	ASP.NET ページフレームワークによって呼び出され、ポストバックまたはレンダリングの準備として、合成ベースの実装を使うサーバーコントロールに対し、それらのコントロールに含まれる子コントロールを作成するように通知します。 (継承元 Control)
CreateControlCollection()	Web ページ上の WebPartManager コントロールで管理されるすべてのコントロールのコレクションを返します。このクラスは継承できません。
CreateDisplayModes()	Web パーツアプリケーションで使用できるすべての表示モードのセットを作成します。
CreateDynamicConnectionID()	動的接続の ID として使用される一意の値を取得します。
CreateDynamicWebPartID(Type)	動的な WebPart コントロールの一意の ID を生成します。
CreateErrorWebPart(String, String, String, String, String)	動的な WebPart コントロールを読み込むか作成しようとして何らかの理由で失敗したときに、ページに挿入してエンドユーザーに表示する特別なコントロールを作成します。
CreatePersonalization()	現在の Web ページのユーザーのパーソナル化データを格納するパーソナル化オブジェクトを返します。
CreateWebPart(Control)	WebPart オブジェクトを持った GenericWebPart コントロール以外のサーバーコントロールが Web パーツ機能を備えることができるように、そのコントロールをラップします。
DataBind()	呼び出されたサーバーコントロールとそのすべての子コントロールにデータソースをバインドします。 (継承元 Control)
DataBind(Boolean)	DataBinding イベントを発生させるオプションを指定して、呼び出されたサーバーコントロールとそのすべての子コントロールにデータソースをバインドします。 (継承元 Control)
DataBindChildren()	データソースをサーバーコントロールの子コントロールにバインドします。 (継承元 Control)
DeleteWebPart(WebPart)	WebPart コントロールの動的インスタンスを Web ページから完全に削除します。
DisconnectWebPart(WebPart)	終了または削除する WebPart コントロールまたはサーバーコントロールを、それが関係する接続から削除します。
DisconnectWebParts(WebPartConnection)	Web ページ上で接続されたサーバーコントロールの接続を解除するプロセスを実行します。
Dispose()	サーバーコントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。 (継承元 Control)
EndRenderTracing(TextWriter, Object)	レンダリングデータのデザイン時のトレースを終了します。 (継承元 Control)
EndWebPartConnecting()	一方の WebPart コントロールをもう一方のコントロールに接続するプロセスを完了させます。
EndWebPartEditing()	WebPart コントロールを編集するプロセスを完了させます。
EnsureChildControls()	サーバーコントロールに子コントロールが含まれているかどうかを確認します。含まれていない場合、子コントロールを作成します。 (継承元 Control)
EnsureID()	ID が割り当てられていないコントロールの ID を作成します。 (継承元 Control)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
ExportWebPart(WebPart, XmlWriter)	サーバーコントロールの状態データとプロパティデータが格納された XML 記述ファイルを作成します。
FindControl(String)	指定した `id` パラメーターを使用して、サーバーコントロールの現在の名前付けコンテナーを検索します。 (継承元 Control)
FindControl(String, Int32)	指定した `id` および検索に役立つ `pathOffset` パラメーターに指定された整数を使用して、サーバーコントロールの現在の名前付けコンテナーを検索します。この形式の FindControl メソッドはオーバーライドしないでください。 (継承元 Control)
Focus()	オーバーライドして、ユーザーインターフェイス (UI) のない WebPartManager コントロールにフォーカスが設定されるのを防ぎます。
GetConsumerConnectionPoints(WebPart)	Web パーツ接続内でコンシューマーとして動作するサーバーコントロールから、コネクションポイントとして機能できる ConsumerConnectionPoint オブジェクトのコレクションを取得します。
GetCurrentWebPartManager(Page)	ページ上の WebPartManager コントロールの現在のインスタンスへの参照を取得します。
GetDesignModeState()	コントロールのデザイン時データを取得します。 (継承元 Control)
GetDisplayTitle(WebPart)	DisplayTitle コントロールの WebPart プロパティの値が含まれた文字列を取得します。
GetExportUrl(WebPart)	ユーザーが WebPart コントロールをエクスポートしようとするときの要求に含まれる相対仮想パスとクエリ文字列を取得します。
GetGenericWebPart(Control)	サーバーコントロールが含まれた GenericWebPart コントロールのインスタンスへの参照を取得します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetProviderConnectionPoints(WebPart)	Web パーツ接続内でプロバイダーとして動作するサーバーコントロールから、コネクションポイントとして機能できる ProviderConnectionPoint オブジェクトのコレクションを取得します。
GetRouteUrl(Object)	ルートパラメーターのセットに対応する URL を取得します。 (継承元 Control)
GetRouteUrl(RouteValueDictionary)	ルートパラメーターのセットに対応する URL を取得します。 (継承元 Control)
GetRouteUrl(String, Object)	ルートパラメーターのセットおよびルート名に対応する URL を取得します。 (継承元 Control)
GetRouteUrl(String, RouteValueDictionary)	ルートパラメーターのセットおよびルート名に対応する URL を取得します。 (継承元 Control)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetUniqueIDRelativeTo(Control)	指定されたコントロールの UniqueID プロパティのプレフィックス部分を返します。 (継承元 Control)
HasControls()	サーバーコントロールに子コントロールが含まれているかどうかを確認します。 (継承元 Control)
HasEvents()	コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。 (継承元 Control)
ImportWebPart(XmlReader, String)	WebPart コントロールの状態データとプロパティデータが格納された XML 記述ファイルをインポートし、コントロールにそのデータを適用します。
IsAuthorized(Type, String, String, Boolean)	ページへのコントロールの追加が承認されているかどうかを判断する最後の手順を実行します。
IsAuthorized(WebPart)	ページへのコントロールの追加が承認されているかどうかを判断する最初の手順を実行します。
IsLiteralContent()	サーバーコントロールがリテラルな内容だけを保持しているかどうかを決定します。 (継承元 Control)
LoadControlState(Object)	前回のページ要求で保存され、後続の要求で復元する必要のある、コントロールの状態データを読み込みます。
LoadCustomPersonalizationState(PersonalizationDictionary)	初期化プロセス中に後で使用するためにパーソナル化オブジェクトによって WebPartManager コントロールに渡されたカスタムのパーソナル化データを格納します。
LoadViewState(Object)	SaveViewState() メソッドによって保存された前回のページ要求からビューステート情報を復元します。 (継承元 Control)
MapPathSecure(String)	仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。 (継承元 Control)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MoveWebPart(WebPart, WebPartZoneBase, Int32)	1 つの WebPart ゾーンから別のゾーンまたは同じゾーン内の新しい位置に、WebPartZoneBase コントロールまたはサーバーコントロールを移動します。
OnAuthorizeWebPart(WebPartAuthorizationEventArgs)	AuthorizeWebPart イベントを発生させ、イベントのハンドラーが存在する場合はそれを呼び出します。
OnBubbleEvent(Object, EventArgs)	サーバーコントロールのイベントをページの UI サーバーコントロールの階層構造に渡すかどうかを決定します。 (継承元 Control)
OnConnectionsActivated(EventArgs)	ページとそのコントロールが読み込まれ、ページの接続がアクティブになってデータの共有が開始されることを示す ConnectionsActivated イベントを発生させます。
OnConnectionsActivating(EventArgs)	ページとそのコントロールが読み込まれ、接続をアクティブにするプロセスを開始できることを示す ConnectionsActivating イベントを発生させます。
OnDataBinding(EventArgs)	DataBinding イベントを発生させます。 (継承元 Control)
OnDisplayModeChanged(WebPartDisplayModeEventArgs)	Web ページ上で DisplayModeChanged コントロールが、ある表示モードから別の表示モードに切り替えるプロセスを完了したことを示す、WebPartManager イベントを発生させます。
OnDisplayModeChanging(WebPartDisplayModeCancelEventArgs)	Web ページ上で DisplayModeChanging コントロールが、ある表示モードから別の表示モードに切り替えるプロセスを実行していることを示す、WebPartManager イベントを発生させます。
OnInit(EventArgs)	Init コントロールの有効期間における最初のイベントとして、WebPartManager イベントを発生させます。
OnLoad(EventArgs)	Load イベントを発生させます。 (継承元 Control)
OnPreRender(EventArgs)	Web ページに PreRender コントロールを表示する直前に発生する、WebPartManager イベントを発生させます。
OnSelectedWebPartChanged(WebPartEventArgs)	SelectedWebPartChanged コントロールを新しく選択した後またはその選択を解除した後に発生する、WebPart イベントを発生させます。
OnSelectedWebPartChanging(WebPartCancelEventArgs)	現在選択されている SelectedWebPartChanging コントロールから選択を他に変更するプロセスを実行しているときに発生する、WebPart イベントを発生させます。
OnUnload(EventArgs)	Unload 基本イベントを発生させ、Web ページから WebPartManager インスタンスを削除します。
OnWebPartAdded(WebPartEventArgs)	WebPartAdded コントロールがページに追加された後に発生する、WebPart イベントを発生させます。
OnWebPartAdding(WebPartAddingEventArgs)	WebPartAdding コントロール (あるいは、サーバーコントロールまたはユーザーコントロール) を WebPart ゾーンに追加するプロセスを実行しているときに発生する、WebPartZoneBase イベントを発生させます。
OnWebPartClosed(WebPartEventArgs)	コントロールがページから削除されたことを通知する WebPartClosed イベントを発生させます。
OnWebPartClosing(WebPartCancelEventArgs)	ページから WebPartClosing コントロールまたはサーバーコントロールを削除するプロセスを実行しているときに発生する、WebPart イベントを発生させます。
OnWebPartDeleted(WebPartEventArgs)	WebPartDeleted コントロールがページから完全に削除された後に発生する、WebPart イベントを発生させます。
OnWebPartDeleting(WebPartCancelEventArgs)	動的な WebPartDeleting コントロール (または、WebPart ゾーンに配置されたサーバーコントロールまたはユーザーコントロール) を削除するプロセスを実行していることを示す、WebPartZoneBase イベントを発生させます。
OnWebPartMoved(WebPartEventArgs)	WebPartMoved コントロールがページ上の別の位置に移動された後に発生する、WebPart イベントを発生させます。
OnWebPartMoving(WebPartMovingEventArgs)	WebPartMoving ゾーン内の WebPart コントロール (あるいは、サーバーコントロールまたはユーザーコントロール) を移動するプロセスを実行していることを示す、WebPartZoneBase イベントを発生させます。
OnWebPartsConnected(WebPartConnectionsEventArgs)	WebPartsConnected コントロールの間に接続が確立された後に発生する、WebPart イベントを発生させます。
OnWebPartsConnecting(WebPartConnectionsCancelEventArgs)	WebPartsConnecting ゾーンに配置されている 2 つの WebPart コントロール (あるいは、サーバーコントロールまたはユーザーコントロール) の間に接続を確立するプロセスを実行しているときに発生する、WebPartZoneBase イベントを発生させます。
OnWebPartsDisconnected(WebPartConnectionsEventArgs)	WebPartsDisconnected コントロール間の接続が終了した後に発生する、WebPart イベントを発生させます。
OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs)	WebPartsDisconnecting ゾーン内の 2 つの WebPart コントロール (あるいは、サーバーコントロールまたはユーザーコントロール) の接続を終了するプロセスを実行していることを示す、WebPartZoneBase イベントを発生させます。
OpenFile(String)	ファイルの読み込みで使用される Stream を取得します。 (継承元 Control)
RaiseBubbleEvent(Object, EventArgs)	イベントのソースおよびその情報をコントロールの親に割り当てます。 (継承元 Control)
RegisterClientScript()	WebPartManager コントロールで、Web ページ内における WebPart コントロールのドラッグなど、さまざまなパーソナル化機能に使用するクライアント側スクリプトを生成できるようにします。
RemovedControl(Control)	Control オブジェクトの Controls コレクションから子コントロールが削除された後に呼び出されます。 (継承元 Control)
Render(HtmlTextWriter)	オーバーライドして、WebPartManager コントロールが何らかの内容を表示するのを防ぎます。
RenderChildren(HtmlTextWriter)	提供された HtmlTextWriter オブジェクトに対してサーバーコントロールの子のコンテンツを出力すると、クライアントで表示されるコンテンツが記述されます。 (継承元 Control)
RenderControl(HtmlTextWriter)	指定の HtmlTextWriter オブジェクトにサーバーコントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。 (継承元 Control)
RenderControl(HtmlTextWriter, ControlAdapter)	指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバーコントロールの内容を出力します。 (継承元 Control)
ResolveAdapter()	指定したコントロールを表示するコントロールアダプターを取得します。 (継承元 Control)
ResolveClientUrl(String)	ブラウザーで使用できる URL を取得します。 (継承元 Control)
ResolveUrl(String)	要求側クライアントで使用できる URL に変換します。 (継承元 Control)
SaveControlState()	WebPartManager コントロールの状態データを保存し、今後このコントロールが含まれた Web ページを要求されたときにそのデータを復元できるようにします。
SaveCustomPersonalizationState(PersonalizationDictionary)	WebPartManager コントロールによって管理されるカスタムのパーソナル化状態データを保存します。これにより、ページの再読み込みを行うたびにこのデータを読み込めるようになります。
SaveViewState()	ページがサーバーにポストバックされた時間以降に発生した、サーバーコントロールのビューステートの変更を保存します。 (継承元 Control)
SetDesignModeState(IDictionary)	コントロールのデザイン時データを設定します。 (継承元 Control)
SetPersonalizationDirty()	WebPartManager コントロールのカスタムのパーソナル化データが変更されたことを示すフラグを設定します。
SetRenderMethodDelegate(RenderMethod)	サーバーコントロールとその内容を親コントロールに表示するイベントハンドラーデリゲートを割り当てます。 (継承元 Control)
SetSelectedWebPart(WebPart)	現在選択されている SelectedWebPart コントロールまたはサーバーコントロールと同じ WebPart プロパティ値を設定します。
SetTraceData(Object, Object)	トレースデータキーとトレースデータ値を使用して、レンダリングデータのデザイン時トレースのトレースデータを設定します。 (継承元 Control)
SetTraceData(Object, Object, Object)	トレースされたオブジェクト、トレースデータキー、およびトレースデータ値を使用して、レンダリングデータのデザイン時トレースのトレースデータを設定します。 (継承元 Control)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
TrackViewState()	パーソナル化状態データを WebPartManager コントロールに適用し、基本メソッドを呼び出してコントロールのビューステートデータに対する変更を追跡できるようにします。

イベント

AuthorizeWebPart	IsAuthorized メソッドを呼び出すと発生し、WebPart コントロールまたはサーバーコントロールをページに追加できるかどうかを判断します。
ConnectionsActivated	ページ上の現在の Web パーツ接続すべてが接続され、さらにそれぞれの接続に関係するコンシューマーコントロールとプロバイダーコントロールの間にアクティブなデータの共有が開始された後に発生します。
ConnectionsActivating	Web ページ上で確立されたすべての Web パーツ接続をアクティブにするプロセスを実行しているときに発生します。
DataBinding	サーバーコントロールがデータソースに連結すると発生します。 (継承元 Control)
DisplayModeChanged	Web パーツページ上の現在の表示モードが変更された後に発生します。
DisplayModeChanging	Web ページ上で別の表示モードに変更するプロセスを開始する動詞をユーザーがクリックした後に発生します。
Disposed	サーバーコントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバーコントロールの有効期間における最終段階です。 (継承元 Control)
Init	サーバーコントロールが初期化されると発生します。これは、サーバーコントロールの有効期間における最初の手順です。 (継承元 Control)
Load	サーバーコントロールが Page オブジェクトに読み込まれると発生します。 (継承元 Control)
PreRender	Control オブジェクトの読み込み後、表示を開始する前に発生します。 (継承元 Control)
SelectedWebPartChanged	ある WebPart コントロールの選択を変更して Web ページ上の別のコントロールに移動した後に発生します。
SelectedWebPartChanging	Web ページ上で現在選択されている WebPart コントロールまたはサーバーコントロールの変更プロセス中に発生します。
Unload	サーバーコントロールがメモリからアンロードされると発生します。 (継承元 Control)
WebPartAdded	動的な WebPart コントロールまたはその他のサーバーコントロールを WebPartZoneBase ゾーンに追加した後に発生し、そのコントロールが正常に追加されたことを示します。
WebPartAdding	動的な WebPart コントロールまたはその他のサーバーコントロールを WebPartZoneBase ゾーンに追加するプロセスを実行しているときに発生します。
WebPartClosed	WebPart コントロール (あるいは、サーバーコントロールまたはユーザーコントロール) をページから削除すると発生します。
WebPartClosing	WebPart コントロール (あるいは、サーバーコントロールまたはユーザーコントロール) をページから削除するプロセスを実行しているときに発生します。
WebPartDeleted	WebPart コントロールまたはその他のサーバーコントロールを WebPartZoneBase ゾーンから削除した後に発生します。
WebPartDeleting	動的な WebPart コントロールまたはその他のサーバーコントロールのインスタンスを WebPartZoneBase ゾーンから完全に削除するプロセスを実行しているときに発生します。
WebPartMoved	WebPart コントロールまたはサーバーコントロールを、Web ページ上の別の位置に移動した後に発生します。
WebPartMoving	WebPart ゾーンに配置されている WebPartZoneBase コントロールまたはその他のサーバーコントロールを移動するプロセスを実行しているときに発生します。
WebPartsConnected	WebPart コントロール (あるいは、サーバーコントロールまたはユーザーコントロール) の間に特定の接続が確立された後に発生します。
WebPartsConnecting	WebPart コントロール (または、WebPartZoneBase ゾーンに配置されたサーバーコントロールまたはユーザーコントロール) の間に接続を作成するプロセスを実行しているときに発生します。
WebPartsDisconnected	2 つの WebPart コントロールまたはサーバーコントロール間の接続が終了した後に発生します。
WebPartsDisconnecting	以前に接続した WebPart コントロールまたはサーバーコントロール間の接続を終了するプロセスを実行しているときに発生します。

明示的なインターフェイスの実装

IControlBuilderAccessor.ControlBuilder	このメンバーの詳細については、「ControlBuilder」をご覧ください。 (継承元 Control)
IControlDesignerAccessor.GetDesignModeState()	このメンバーの詳細については、「GetDesignModeState()」をご覧ください。 (継承元 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	このメンバーの詳細については、「SetDesignModeState(IDictionary)」をご覧ください。 (継承元 Control)
IControlDesignerAccessor.SetOwnerControl(Control)	このメンバーの詳細については、「SetOwnerControl(Control)」をご覧ください。 (継承元 Control)
IControlDesignerAccessor.UserData	このメンバーの詳細については、「UserData」をご覧ください。 (継承元 Control)
IDataBindingsAccessor.DataBindings	このメンバーの詳細については、「DataBindings」をご覧ください。 (継承元 Control)
IDataBindingsAccessor.HasDataBindings	このメンバーの詳細については、「HasDataBindings」をご覧ください。 (継承元 Control)
IExpressionsAccessor.Expressions	このメンバーの詳細については、「Expressions」をご覧ください。 (継承元 Control)
IExpressionsAccessor.HasExpressions	このメンバーの詳細については、「HasExpressions」をご覧ください。 (継承元 Control)
IParserAccessor.AddParsedSubObject(Object)	このメンバーの詳細については、「AddParsedSubObject(Object)」をご覧ください。 (継承元 Control)
IPersonalizable.IsDirty	WebPartManager コントロールによって管理されているカスタムのパーソナル化状態データが Web ページ上で変更されたかどうかを示す値を取得します。
IPersonalizable.Load(PersonalizationDictionary)	WebPartManager コントロールに読み込む必要がある、以前に保存したカスタムのパーソナル化状態データを返します。
IPersonalizable.Save(PersonalizationDictionary)	WebPartManager コントロールで管理されるカスタムのパーソナル化状態データを保存します。

拡張メソッド

FindDataSourceControl(Control)	指定されたコントロールのデータコントロールに関連付けられているデータソースを返します。
FindFieldTemplate(Control, String)	指定されたコントロールの名前付けコンテナー内にある、指定された列のフィールドテンプレートを返します。
FindMetaTable(Control)	格納しているデータコントロールのメタテーブルオブジェクトを返します。
GetDefaultValues(INamingContainer)	指定されたデータコントロールの既定値のコレクションを取得します。
GetMetaTable(INamingContainer)	指定されたデータコントロールのテーブルメタデータを取得します。
SetMetaTable(INamingContainer, MetaTable)	指定されたデータコントロールのテーブルメタデータを設定します。
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	指定したデータコントロールのテーブルメタデータおよび既定値のマッピングを設定します。
SetMetaTable(INamingContainer, MetaTable, Object)	指定したデータコントロールのテーブルメタデータおよび既定値のマッピングを設定します。
TryGetMetaTable(INamingContainer, MetaTable)	テーブルメタデータが使用できるかどうかを判断します。
EnableDynamicData(INamingContainer, Type)	指定されたデータコントロールの動的データの動作を有効にします。
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	指定されたデータコントロールの動的データの動作を有効にします。
EnableDynamicData(INamingContainer, Type, Object)	指定されたデータコントロールの動的データの動作を有効にします。

適用対象

次の方法で共有