WebPartCollection クラス

リファレンス

定義

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

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

重要

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

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

public ref class WebPartCollection sealed : System::Collections::ReadOnlyCollectionBase

public sealed class WebPartCollection : System.Collections.ReadOnlyCollectionBase

type WebPartCollection = class
    inherit ReadOnlyCollectionBase

Public NotInheritable Class WebPartCollection
Inherits ReadOnlyCollectionBase

継承: Object

ReadOnlyCollectionBase
WebPartCollection

例

次のコード例では、Web パーツページでオブジェクトを WebPartCollection 使用する方法を示します。この例には、次の 3 つの部分があります。

部分クラス内のページのコード。
コントロールを含む Web ページ。
ブラウザーでのこの例の動作の説明。

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

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";
  }
}

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

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

<%@ Page Language="C#" 
  Codefile="webpartcollection.cs" 
  Inherits="webpartcollectioncs" %>

<!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">
    <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="vb"
  Codefile="webpartcollection.vb" 
  Inherits="webpartcollectionvb" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>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>

ブラウザーでページを読み込み、[ ChromeState の切り替え ] ボタンをクリックすると、部分クラスのコードがオブジェクトを WebPartCollection ループ処理し、コントロールを最小化するか、通常の状態に戻します。または、[ 箇条書きリスト 1 タイトルの切り替え ] ボタンを繰り返しクリックすると、最上位のコントロールのタイトルが代替値に変更されます。

注釈

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

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

注意

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

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

コンストラクター

WebPartCollection()	WebPartCollection クラスの新しい空のインスタンスを初期化します。
WebPartCollection(ICollection)	WebPartCollection オブジェクトの新しいインスタンスを、ICollection コントロールの WebPart コレクションで渡して初期化します。

プロパティ

Count	ReadOnlyCollectionBase インスタンスに含まれる要素の数を取得します。 (継承元 ReadOnlyCollectionBase)
InnerList	ReadOnlyCollectionBase インスタンスに格納されている要素のリストを取得します。 (継承元 ReadOnlyCollectionBase)
Item[Int32]	コレクションにおける位置に基づいてコレクションのメンバーを返します。
Item[String]	一意の文字列識別子に基づいて、コレクションのメンバーを返します。

メソッド

Contains(WebPart)	特定のコントロールがコレクション内に存在するかどうかを示す値を返します。
CopyTo(WebPart[], Int32)	コレクションを WebPart オブジェクトの配列にコピーします。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetEnumerator()	ReadOnlyCollectionBase インスタンスを反復処理する列挙子を返します。 (継承元 ReadOnlyCollectionBase)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IndexOf(WebPart)	コレクション内の特定のメンバーの位置を返します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

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

ICollection.CopyTo(Array, Int32)	ReadOnlyCollectionBase 全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。 (継承元 ReadOnlyCollectionBase)
ICollection.IsSynchronized	ReadOnlyCollectionBase オブジェクトへのアクセスが同期されている (スレッドセーフである) かどうかを示す値を取得します。 (継承元 ReadOnlyCollectionBase)
ICollection.SyncRoot	ReadOnlyCollectionBase オブジェクトへのアクセスを同期するために使用できるオブジェクトを取得します。 (継承元 ReadOnlyCollectionBase)

拡張メソッド

Cast<TResult>(IEnumerable)	IEnumerable の要素を、指定した型にキャストします。
OfType<TResult>(IEnumerable)	指定された型に基づいて IEnumerable の要素をフィルター処理します。
AsParallel(IEnumerable)	クエリの並列化を有効にします。
AsQueryable(IEnumerable)	IEnumerable を IQueryable に変換します。

適用対象

次の方法で共有