WebPartZoneBase.WebParts プロパティ

.NET Framework クラス ライブラリ リファレンス

WebPartZoneBase.WebParts プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ゾーン内に含まれる Web パーツ コントロールのコレクションを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 WebParts As WebPartCollection

Visual Basic (使用法)

Dim instance As WebPartZoneBase
Dim value As WebPartCollection

value = instance.WebParts

C#

public WebPartCollection WebParts { get; }

C++

public:
property WebPartCollection^ WebParts {
    WebPartCollection^ get ();
}

J#

/** @property */
public WebPartCollection get_WebParts ()

JScript

public function get WebParts
 () : WebPartCollection

プロパティ値
ゾーン内のすべての Web パーツ コントロールへの参照を含む WebPartCollection。

解説

WebParts プロパティには、WebPart クラスから直接継承されるコントロールへの参照、およびゾーン内の他の ASP.NET サーバー コントロールまたはカスタム コントロールへの参照を含めることができます。Web パーツ コントロール セットは、実行時に WebPart コントロールではないコントロールを GenericWebPart コントロールとして動的にラップします。これにより、すべてのタイプの ASP.NET コントロールを Web パーツ コントロールとして使用できます。

使用例

WebPartZone コントロールで WebParts プロパティをプログラムによって使用するコード例を次に示します。分離コード ソース ファイルおよびこのコードのゾーンを含む .aspx ページなどコード例全体については、WebPartZoneBase クラスの概要を参照してください。

WebParts プロパティにプログラムによってアクセスし、WebPartZone1 に含まれるコントロールのリストを表示するコード例を次に示します。ブラウザにページを読み込んだ後、[List WebPartZone2 WebParts] というラベルのボタンをクリックします。コントロールの ID およびタイプが表示されます。

Visual Basic

Protected Sub Button3_Click(ByVal
 sender As Object, ByVal
 e As EventArgs) 
  Dim builder As New StringBuilder()
  builder.AppendLine("<strong>WebPartZone2 WebPart IDs</strong><br
 />")
  Dim part As WebPart
  For Each part In  WebPartZone1.WebParts
    builder.AppendLine("ID: " + part.ID + ";
 Type: " _
                        + part.GetType().ToString() _
                        + "<br />")
  Next part
  Label2.Text = builder.ToString()
  Label2.Visible = True
End Sub 

C#

protected void Button3_Click(object sender,
 EventArgs e)
{
  StringBuilder builder = new StringBuilder();
  builder.AppendLine(@"<strong>WebPartZone1 WebPart IDs</strong><br
 />");
  foreach (WebPart part in WebPartZone1.WebParts)
  {
    builder.AppendLine("ID: " + part.ID 
                        + "; Type:  " + part.GetType() 
                        + @"<br />");
  }
  Label2.Text = builder.ToString();
  Label2.Visible = true;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartZoneBase クラス
WebPartZoneBase メンバ
System.Web.UI.WebControls.WebParts 名前空間
WebPartManager.WebParts プロパティ
その他の技術情報
ASP.NET Web パーツ ページ