WebPartCollection クラスとは? わかりやすく解説

WebPartCollection クラス

メモ : このクラスは、.NET Framework version 2.0新しく追加されたものです。

関連するコントロールグループ追跡および管理のために使用される WebPart コントロールコレクション格納します。このクラス継承できません。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文構文

Public NotInheritable Class
 WebPartCollection
    Inherits ReadOnlyCollectionBase
Dim instance As WebPartCollection
public sealed class WebPartCollection : ReadOnlyCollectionBase
public ref class WebPartCollection sealed :
 public ReadOnlyCollectionBase
public final class WebPartCollection extends
 ReadOnlyCollectionBase
public final class WebPartCollection extends
 ReadOnlyCollectionBase
解説解説

WebPartCollection クラスは、コントロール読み取り専用コレクションで、通常、WebPartZoneBase コントロールおよび WebPartManager コントロールによって WebPart コントロールセット管理するために使用されます。

WebPartManager コントロールは、WebPartCollection オブジェクト使用してページ上のすべての WebPart コントロールリスト保持します。それに対してWebPartZoneBase コントロールは、WebPartCollection オブジェクト使用してそのコレクション含まれる WebPart コントロール追跡します

メモメモ

WebPartCollection コレクションは、WebPart コントロールと、WebPartZoneBase ゾーン内に配置されWeb パーツ アプリケーション一部として使用される他のサーバー コントロール (ユーザー コントロールカスタム コントロールASP.NET コントロールなど) の両方格納します。たとえば、ページに WebPartZone ゾーン存在しており、そのゾーン内でカスタム WebPart コントロールASP.NET Calendar コントロール宣言すると、両方コントロールが、WebPartCollection コレクション内で WebParts プロパティによって参照されます。

WebPartCollection オブジェクトによって、Web パーツ コントロール セットは、厳密に指定されコレクション使用できます同様にWebPart コントロールセットに対して大量操作一括して実行する場合WebParts プロパティ使用して WebPartCollection オブジェクトへの参照取得できます。たとえば、ページすべての WebPart コントロール反復処理して、なんらかの方法でそれらの外観変更することが必要な場合ありますWebPartCollection オブジェクト読み取り専用ですが、コレクション参照される基になるコントロールプロパティプログラムによって変更することはできます

使用例使用例

Web パーツ ページWebPartCollection オブジェクト使用する方法次のコード例示します。この例は、3 つの部分構成されます。

コード例最初部分には、部分クラス内のページコード含まれます。Button1_Click メソッドは、WebPartManager.WebParts プロパティ参照されるすべての WebPart コントロール構成される WebPartCollection オブジェクト作成します。このオブジェクトには、ページ上のすべての WebPart コントロール含まれます。このメソッドは、すべてのコントロール反復処理して、コントロール標準の状態かまたは最小化状態かを決定するコントロールの ChromeState プロパティの値を切り替えます

Imports System
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Partial Public Class webpartcollectionvb

  Inherits System.Web.UI.Page

  Protected Sub Button1_Click(ByVal
 sender As Object, ByVal
 e As System.EventArgs)

    Dim partCollection As WebPartCollection
 = mgr1.WebParts
    Dim part As WebPart

    For Each part In partCollection
      If part.ChromeState <> PartChromeState.Minimized Then
        part.ChromeState = PartChromeState.Minimized
      Else
        part.ChromeState = PartChromeState.Normal
      End If
    Next

  End Sub

  Protected Sub Button2_Click(ByVal
 sender As Object, ByVal
 e As System.EventArgs)

    Dim partCollection As WebPartCollection
 = WebPartZone1.WebParts

    If partCollection(0).Title = "My Link List"
 Then
      partCollection(0).Title = "Favorite Links"
    Else
      partCollection(0).Title = "My Link List"
    End If

  End Sub

End Class
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

public partial class webpartcollectioncs :
 System.Web.UI.Page
{
  protected void Button1_Click(object sender,
 EventArgs e)
  {

    WebPartCollection partCollection = mgr1.WebParts;

    foreach (WebPart part in partCollection)
    {
      if (part.ChromeState != PartChromeState.Minimized)
        part.ChromeState = PartChromeState.Minimized;
      else
        part.ChromeState = PartChromeState.Normal;
    }
  }
  protected void Button2_Click(object sender,
 EventArgs e)
  {
    WebPartCollection partCollection = WebPartZone1.WebParts;

    if (partCollection[0].Title == "My Link List")
      partCollection[0].Title = "Favorite Links";
    else
      partCollection[0].Title = "My Link List";
  }
}

コード例2 番目の部分は、コントロール含んでいる Web ページです。WebPartZone1 内で宣言されているコントロール標準 ASP.NET サーバー コントロールです。しかし、それらのコントロールは、実行時に GenericWebPart コントロールとしてラップされ、GenericWebPart クラスWebPart クラスから継承されるため、実行時自動的に WebPart コントロールとして扱われ結果として WebPartCollection オブジェクト含まれます。

<%@ Page Language="vb"
  Codefile="webpartcollection.vb" 
  Inherits="webpartcollectionvb"
 %>

<html  >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server"
 />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
          <br />
          <asp:Calendar ID="Calendar1" runat="server"
 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    <hr />
    <asp:Button ID="Button1" runat="server"
 Width="200"
      Text="Toggle ChromeState" OnClick="Button1_Click"
 />
    <br />
    <asp:Button ID="Button2" runat="server"
 Width="200"
        Text="Toggle BulletedList1 Title" 
        OnClick="Button2_Click"/>
    </form>
</body>
</html>
<%@ Page Language="C#" 
  Codefile="webpartcollection.cs" 
  Inherits="webpartcollectioncs" %>

<html  >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
          <br />
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ChromeState" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
        Text="Toggle BulletedList1 Title" 
        OnClick="Button2_Click"/>
    </form>
</body>
</html>

ブラウザページ読み込み、[Toggle ChromeState] をクリックすると、部分クラスコードWebPartCollection オブジェクト反復処理して、各コントロール最小化するか標準の状態に戻します。または、繰り返し [Toggle BulletedList1 Title] ボタンクリックすると、最前面のコントロールタイトルの値が交互に入れ替わります。

.NET Framework のセキュリティ.NET Frameworkセキュリティ
継承階層継承階層
System.Object
   System.Collections.ReadOnlyCollectionBase
    System.Web.UI.WebControls.WebParts.WebPartCollection
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「WebPartCollection クラス」の関連用語

WebPartCollection クラスのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



WebPartCollection クラスのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS